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ABSTRACT 
This study discusses briefly the history of technical figure illustration in the 
Computer Science Department of the Naval Postgraduate School. The single 
system experiencing the most usage is the fully automated interactive graphics 
figure illustrator--OZDRAW. During its short and active life, the need for 
perfective maintenance to include generalized documentation has been recognized. 
The result is a technical graphics figure illustrator with an improved user interface 


titled NPSDRAW and supporting documentation. 
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I. INTRODUCTION 


A. A NEED FOR AUTOMATED FIGURE ILLUSTRATORS 

In academic environments, graphical figures must be made available within a 
period of time equal to that of the time to complete the text. As word processors 
gain speed and can interact with assorted programs that check spelling, 
compute arithmetic values within text and even evaluate writing style, there is 
the need for a quick effective means of providing associated illustrations. The 
pressure upon the illustrator for completion of his product is increased each time 
new software and/or hardware provides faster output of a final text product. 
The only means by which the illustrator can keep pace with the word processor 
improvements is to utilize a system that is quick, easy to learn, powerful and 
uncomplicated to operate even for the most infrequent user. 

In the Computer Science (CS) Department of the Naval Postgraduate School, 
the need for semi-automated or fully automated illustration systems has been 
served by a variety of systems such as the PIC Graphics Language, FIGURE 
Graphics Illustrator Program and most recently. OZDRAW, an interactive 
graphics figure illustrator. PIC is a procedural language, in which the user 
specifies the motions that one goes through drawing a figure. The language is the 


implementation of a "semi-automated" system, i.e. having no real-time computer 


graphics representation during the drawing process. The user must maintain a 
mental or physical image of his proposed drawing, and utilize multiple drawing 
commands, variable names and values, positioning data and attributes to provide 
the input "coded text" before generation of his final product. 

FIGURE is a departmentally produced semi-automated system that produces 
an illustration by using the users input of coded text similar to that of PIC. 
FIGURE requires only the primitive figure name and position to be drawn. 
Various line styles, line widths, fonts and fill patterns are simply identified as 
change is required. The text then is processed to generate the final product. 

OZDRAW is the first fully automated system available for general usage 
within the CS department. The user has real-time feedback in the form of a 
drawing on a monitor of a graphics workstation. This system actually permits the 
user to do the actual drawing. The drawing is then converted to data acceptable 
by FIGURE. OZDRAW does not require the user to learn, nor even be concerned 
- with the assignment of primitives, positioning data or attribute assignment format 
in the "coded text" file used by FIGURE. The user simply draws his illustration 
on the monitor, saves it to a file, and then prints out that illustration by invoking 


FIGURE. 


B. SYSTEM DRAWBACKS 
1. PIC Graphics Language 

As with all semi-automated systems, the major deficiency of PIC is the 
lack of real-time feedback as the product is "laid out" or drawn before actual 
printing. This requires the user to have a detailed sketch or hand drawn 
illustration to work from and determine specific numeric values. The program 
then must be written to reflect the sketch and finally processed for printing. 
Though simple drawings are accomplished somewhat easily, modifications of any 
nature tend to increase the complexity of the code. Modification of figure size, 
attributes, positioning data, as well as, general picture size require a complete 
understanding of the system. PIC is powerful, but complex and sometimes 
difficult even for experienced users. Furthermore, PIC lacks any capability for fill 
patterns. 

2. FIGURE Illustration Program 

FIGURE experiences the same major deficiency of all semi-automated 
systems, i.e. the lack of real-time feedback. It was designed though for use by 
inexperienced and infrequent users. With each primitive figure’s position specified 
in the text. simple modifications to positioning, attributes, etc. are accomplished 
through the simple editing of text. As an illustration increases in size and 
complexity. textual change becomes tedious and difficult. Modification to a single 
figure for repositioning, or attribute change can be accomplished with little 


difficulty, but movement of a block of figures requires extensive editing of the 
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text. As with all semi-automated systems, FIGURE and PIC require the user to 
be knowledgeable of the local text editor on the computer system being used. 
Additionally, the user needs acceptable typing skills to reduce the amount of 
i. and system errors incurred during processing of coded text. 

3. OZDRAW Interactive Graphics Figure Illustrator 

OZDRAW is a real-time, interactive figure generation system. It has been 
designed primarily to run on the IRIS 2400 series of computer graphics 
workstations manufactured by Silicon Graphics, Inc of Mountain View, 
California. The output of the system is designed for any graphics capable laser 
printer. The primary laser printer for the CS department is a Quality Micro 
System (QMS) Lasergraphic 1200 . 

The aim of OZDRAW is to provide a powerful, user-friendly figure 
generation system to enhance the technical figures required by the Computer 
Science Department at the Naval Postgraduate School [Ref. 1]. Since its 
production, OZDRAW has been utilized by a large number of thesis students and 
faculty. It has become the most popular figure illustration system in the 
department. With the system’s popularity, it has become apparent that some of 
the initial design features are a hinderance to the experienced user. Various users 
have expressed a desire to see features expanded, as well as new capabilities added 
to the original version. The following are often cited areas of OZDRAW design 


deficiencies: 


Il 


o Inefficient attribute specification and display features. 


o Menu organization requires traversal through numerous levels to accomplish 
related system functions. 


o Limited font specifications / descriptions. 
o Lack of texture representation during real-time feedback of drawing. 
o Insufficient line width selections. 
o Tedious attribute change mechanics. 
0 Unavailability of common geometric figures. 
o Inability to scale individual figures and blocks of figures. 
o Lack of figure alignment. 


o Foreign figure data utilization / conversion. 

To date. there have been two implementations of OZDRAW put into 
daily use with the differences between the systems being only in the method of 
selecting menu options. This study revolves around the actual maintenance of 
OZDRAW originally written by Steve Firth in 1985/86 |Ref. 1] and examines the 
addition of new features to OZDRAW, retitled NPSDRAW. These changes are 
compatible with the OZDRAW and FIGURE file formats. Primary focus of 


attention is on the overall design and implementation of that new system. 


Il. NPSDRAW: SYSTEM OVERVIEW 


A. SYSTEM CAPABILITIES 
The program used as a basis for NPSDRAW was originally written by Steve 
Firth in a 1985 master’s thesis titled "OZDRAW - An Interactive Graphic Figure 
Illustrator". Our goal was to provide an improved user interface for that system. 
Additionally, new features as well as system enhancements were included. 
1. Primitives Supported by NPSDRAW 
Most figures that are needed in technical figure illustration can be derived 


from the primitives supported by NPSDRAW. The available primitives are listed 


in Table 2.1. 


TABLE 2.1 NPSDRAW PRIMITIVE FIGURES 


Primitives Variations 


Polygons Rectangles, Squares, Diamonds, 
Triangles and Arrowheads 













User Formed Poly gons 


Straight Lines Vertical, Horizontal, Single and 
Multiple Lines 
Smooth Cursive Lines 


Seed Points Used to provide a fill pattern 
(texture) for concave figures 
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2. NPSDRAW Figure Attributes 

Each figure generated with NPSDRAW is assigned specific attributes 
that define its appearance. The attributes are for line width, line style, texture (fill 
pattern) and font. Specific attribute values available are dependent on the current 
graphics printer installed. Table 2.2 shows the default settings and some of 
available settings for the QMS 1200 LaserGraphic Printer currently installed. A 
complete listing available attributes with examples can be found in Appendix A. 

The IRIS workstations provide only one predefined font. All text is 
displayed using that one font. To show size differentials of the actual font as 
displayed on the laser printer. NPSDRAW generates a red rectangle around the 
text. This rectangle represents the actual printed size of the character string. 


Note: this rectangle can be either larger or smaller than the text characters 


TABLE 2.2 FIGURE ATTRIBUTES 
FOR NPSDRAW 


Default Valo 


Line Style Solid Solid, Large Dash, 
Medium Dash, Dotted 


7 
Line Width | 1 pixel (screen), 0.01" (printed) 0.01" to 0.10" (printed) 


Texture 25 possible including, 
Clear, Solid, Shaded, 
Horizontal, Vertical & 
Oblique Lines, and vari- 
ous patterns 

| Over 100 possible: Ro- 
man, San Serif, Type- 
writer, Slanted, Bold, 
Special Symbols, with 
sizes ranging from 6-10 
to 8-15 


Roman 6-LPI, 10-CPI _ 
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displayed. Textures are accurately shown with each figure when drawn. A pallet 
of the available textures is on screen at all times. 
3. The Screen Display 

The primary screen layout of NPSDRAW is shown in Figure 2.1. 
NPSDRAW does not display the entire page but only a clipped version (8.5" x 
8.5") of the page at any one time. The image on the screen is approximately 25% 
larger than the printed image. In horizontal page alignment, the entire height is 
seen, but not the full width. When in vertical alignment, the full width is seen 
but not the height. The user can iio cep ont the page when in editing or drawing 
functions via the Arrow (cursor) keys of the keyboard. 

Initially, NPSDRAW provides a quarter-inch grid overlaying the 
drawing area. Discussion of this grid is covered in section B.1. Superimposed on 
the drawing area is a permanent red dashed rectangle. This rectangle represents 
the thesis margins used at the Naval Postgraduate School. There are no limits 
though on where the user can draw, even to the boundaries of the page. 

The right side of the screen provides instructions for the currently 
selected functions. The current settings of the attributes are also displayed (Figure 
2.2). Lastly a pallet with all possible textures (fill patterns) is maintained for user 
reference and selection of textures in changing attributes (Figure 2.3). 

4. The Printed Page 
NPSDRAW is designed to produce figures for a standard paper size 


(8.5" x 11"); the size cannot be changed. NPSDRAW does allow the picture to be 
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Figure 2.3 Texture (fill pattern) Pallet 
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either vertically oriented (portrait) or horizontally oriented (landscape), i.e. either 
8.5" x 11" or 11" x 8.5" respectively. 
5. The IRIS Mouse and Cursor 
NPSDRAW uses mainly the mouse, and to a lesser extent the keyboard, 
for user input. Menu choices and texture selection are done via the mouse. All 
text is entered via the keyboard. Full screen movement is accomplished via the 
cursor control keys (arrow keys). 
The IRIS mouse has three buttons associated with it, located at the top 
end of the mouse. These buttons are referred in this manual as the Left (LM), 
Middle (MM) and Right (RM) mouse buttons. The locations are self- 
explanatory. Moving the mouse across an appropriate surface moves the position 
of the cursor on the workstation screen. The cursor can appear as a small red 
arrow (menu selections), red crosshairs (texture selection) or black pencil (drawing 
mode). Pressing a button will perform a unique operation for the current 


function*. The function of each button is explained on the screen at all times. 


B. MENU ORGANIZATION 
The program is menu driven with selections made through the use of the 
mouse. The options in a menu are highlighted through movement of the mouse up 


and down. When the appropriate selection is highlighted (arrow and background 


* Sometimes when pressed, the mouse button gives a "double bounce", i.e. it appears to the 
system and its user that the key has been pressed more than once. This occurrence can be annoying 
as it produces results that are not expected. It is therefore recommended that the mouse buttons 
be pressed in a crisp, sharp manner to avoid this situation. 
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color change), it is selected by pressing the middle mouse button (MM). 
Throughout the program, the function of each mouse button is identified on the 
right side of the drawing area in an area titled AB & MOUSE BUTTON 
FUNCTIONS. The organization of the = is discussed in the following 
explanations of each available menu. 

1. Main Menu 

The first menu displayed after start up and selection of the screen 
orientation is the MAIN MENU (Figure 2.4). There are 16 active options in 
the menu. The menu should be thought of as being divided into four functional 
areas: Figure Generation, Page Editing, File Storage & Recall and Attribute 
Selection. 

The first area of Figure Generation is comprised of the first two options. 
"Draw Figures" presents the user with the FIGURE MENU (Figure 2.5) for 
selection of one of the available primitives. Lines are reached through the second 
option "Draw Lines" which presents the LINE MENU (Figure 2.6). Each menu 
lists the various figures and line modes possible. The associated attributes of 
those figures can be changed from the same level. 

The second functional area is comprised of options three thru eight of 
the main menu. These options concern editing the page and specific figures. 
SINGLE EDIT (Figure 2.7) and BLOCK EDIT (Figure 2.8) provide the user 
with means to arrange single or multiple figures on the page. "Figure Attributes" 


selects the FIGURE ATTRIBUTES MENU (Figure 2.9) display and allows 
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MAIN: MENU 
Draw F iqures 
Draw Lines 
Write Text 
ingle Edit 
Block Edit 
Toggle Grid 
Figure Attributes 
Erase Page 
View Page 
Read File 
Write File 
Change LineStyle 
Change LineWidth 
Change Font 
Change Texture 
EXIT SYSTEM 


= 





Figure 2.4 MAIN MENU 
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Figure 2.5 Figure Selection Menu 
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Figure 2.6 Line Selection Menu 
21 













MAIN MENU 
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Write Text 
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Block Edit 
Toqagle Grid 
Fiqure Attributes 
Erase Page 
View Page 
Read File 
Write File 
Change LineStyle 
Change LineWidth 
Change Font 
Change Texture 
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SINGLE EDIT. 


Figure 2.7 Single Edit Menu 
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Figure 2.8 Block Edit Menu 
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the changing of attributes of a selected figure. TOGGLE GRID varies the 
grid overlay between a 1/4", 1/2" and no overlay on the drawing area. This grid 
is not printed on the final product. The grid is displayed in green with the 1/2" 
divisions thicker than the 1/4" divisions. ERASE PAGE (Figure 2.10) clears 
the drawing area and VIEW PAGE permits the user to view his drawing in an 
unclipped format with reduced scale. 

The FILE RECALL MENU (Figure 2.11) is accessed through the 
"Read File" option. The "Write File" option brings up the FILE STORAGE 
MENU (Figure 2.12). 

The last area of the main menu includes the Attribute Change options. 
Each option prompts the user with the steps required to change the desired 
attribute setting. It is through these options that attributes are set for figures yet 
to be drawn. The previously discussed option of "Figure Attributes" allows 
changing attributes of figures already drawn. Finally the last option "Exit 
System", is the option used to terminate the program. 

2. Figure & Line Menus 

The Figure Menu is obtained through the selection of the "Draw 
Figures" option of the Main Menu. This menu permits the selection of the 
drawing routine of rectangles (squares), circles, user specified polygons, ellipses, 
diamonds, triangles, a fixed size arrowhead, and a seed for designating a texture 
for a concave area. The Line Menu provides the options of vertical. horizontal. 


single (any direction), and multiple attached straight lines. A smooth cursive 
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style line and arcs are also available. The attributes associated with the figures 
can also be set from these menus. The "Exit" option returns the user to the Main 
Menu. 

All drawing functions differ slightly in operation but are basically 
similar. To begin drawing, press the middle mouse button (MM). To finish 
drawing, press MM again. The functions of the mouse buttons are always 
displayed. All functions are easy to use and most users are comfortable with the 
drawing process after several minutes of experimentation. However, for 
completeness, a quick procedural sequence for each figure is given in Table 2.3. 

3. Single & Block Edit Menus 

The Single and Block Edit Menus are the two interactive editing 
facilities of NPSDRAW. Single Edit offers movement. deletion, reproduction, or 
recovery of a deleted figure. Selection of individual figures is accomplished by 
positioning the cursor over the control point of a figure and pressing the middle 
mouse button. Control points are corners of a polygon, centers of circles and 
ellipses, ends of lines and arcs, and the beginning of text strings. If an object is 
found, NPSDRAW will cause the figure to blink. The user confirms the blinking 
figure to be correct by pressing the middle mouse button, or else rejects it by 
pressing either outside mouse button. After a figure is rejected, another figure may 
blink if in the bounds of the system’s pick mechanism. Once a figure is confirmed, 
the desired editing function can be performed. If no figure is found, than an error 


message is displayed. 


TABLE 2.3 BRIEF PROCEDURAL DRAWING SEQUENCES 
Rectangles Press the middle mouse button to drop the first comer 


of the rectangle, move the cursor to draw the rectangle 
and press the middle mouse button when finished. 


Circles Press the middle mouse button to choose the center of 
the circle, move the cursor until the circle is drawn, 
pressing the middle mouse button to stop drawing. 


Polygon Press the middle mouse button to drop the first point 
of the polygon, move the cursor and press the middle 
mouse button again to drop subsequent points. When 
the figure is complete press the left mouse button. 


Ellipses, Press the middle mouse button to drop the first corner 

Diamonds, of a rectangle, and move the cursor to draw the 

Triangles rectangle that will circumscnbe the figure. Press the 
middie button when finished and the figure will be 
drawn. 


Arrow heads Designate the position of the arrowhead tip by pressing 
the middle mouse button and select the direction by 
positioning the cursor on the arrowhead axis behind 
the tip. A dotted line will appear indicating the axis. 

_ When in position, press the middie mouse button and 
| the arrow head will be drawn. 
































Drop a seed Select the position of the seed point by pressing the 
middle mouse button. The area that encloses the seed 
point will have the texture currently set. The seed 
point wil] not be printed. 


Single Lines Select the first point using the middle mouse button. 
Move the cursor to complete the line and press the 
middle mouse button to stop. The vertical or 
horizontal line option restricts line drawing to the 
appropniate direction. 


Connected Lines Select the first point using the middle mouse button. 
Move the cursor to subsequent points and drop by 
pressing the middle mouse button. When complete, 
press the left mouse button. 


Smooth Line Press the middle mouse button to set the beginning 
point. Move the cursor as required to complete the line. 
When complete, press the middle mouse button. 


Press the middle mouse button to choose the center of 
the arc. Move the cursor to draw the circle, pressing the 
middie mouse button when the correct radius is 
selected. Next press the middle mouse button to select 
the start of the arc. Move the cursor counter-clockwise 
and press the middle mouse button to select the angle 
of the arc. 
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Block Edit offers movement, deletion. reproduction of two or more 
figures (blocks), movement of the complete picture about the page, and a block 
append mode. Selection of blocks is carried out by the user drawing a special 
rectangle around the desired figures. If any figure has a control point within the 
rectangle, it is included in the selected edit function. 

Movement, deletion and reproduction is similar to the single edit 
function. Moving the entire page is straightforward. The page is reduced into an 
unclipped image so that the user can see the page as a whole. Use of the arrow 
keys moves the picture about the page. This option is useful when a picture is 
complete and requires centering on the page. The Block Append mode permits 
reading in a file but rather than immediately fixing the image to the drawing 
area, it is attached to the cursor for positioning and placement. This facility is 
useful for special figures not in the primitive set. 

4. Figure Attributes 

The Figure Attributes menu is acquired by selection of the "Figure 
Attributes" option presented in either the Main or Figure Menus. The user is 
prompted to select a single figure via control points. Once a figure is accepted, the 
attributes menu appears. Selection of any attribute from the menu activates the 
sequence to change it. Only a single attribute can be changed on a selected figure 
at a time. If additional attributes need to be changed, the figure must be 
reselected. The presentation of this menu is the method for reviewing the 


attributes of a figure. 


5. Clear Screen Menu 

There are two methods for clearing the drawing area of all images. First, 
the user can remove the figures through use of the single or block edit remove 
functions. Individual figures can be recovered at a later time in the same drawing 
session. If complete clearing of the screen is necessary, then selection of the "Erase 
Page" option of the Main Menu displays the Clear Screen Menu. The choices on 
that menu are to "Clear the Screen" or "Continue" drawing. If the picture is not 
stored before erasure, it is lost forever. If the decision to not clear is made, the 
user needs only to select "Continue". 

6. Read & Write File Menus 

To print a file or save a drawing, the figures need be stored in a file. 
Naturally, there is a facility to retrieve this drawing from a file. A directory 
listing is available. listing only those files contained in the user’s current directory. 
The Read and Write operations are selected from the Main Menu and are similar 
in format. The user provides a file name entered from the keyboard. 

If the user wishes to read a files NPSDRAW checks two conditions. First 
it checks if the file exists. If the file does not exist, the user is informed. Second, 
the system checks if any figures are displayed on the screen. If there are, 
NPSDRAW asks the user if he wishes to "Discard" the displayed figures, or 
"Merge" the two files. When writing to a file, NPSDRAW checks if the file exists. 
If it does not, it creates the file and store the figures in it. However, if the file does 


exist, the user is asked if he wishes to "Append" the figures to the end of the file, 
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"Overwrite" the contents or "Quit". Overwriting the contents of a file destroys its 
contents. 
7. Line Style Menu 
The Line Style Menu (Figure 2.13) is presented through selection of the 
"Change LineStyle" option from a menu or via selection of changing the line style 
from the Figure Attributes Menu. The menu lists four line styles. Styles 
currently available are solid (continuous) line, large dashed, medium dashed and 
dotted lines. Upon selection of a style, the user is returned to the controlling 
menu. Whenever the user enters the Line Style Menu, he can exit without 
making any changes. 
8. Line Width Menu 
The Line Width Menu (Figure 2.14) is presented through selection of the 
"Change LineWidth" option from a menu or via selection of changing the line 
width from the Figure Attributes Menu. The menu lists options of line widths 
from 0.01" to 0.10", variable selection and no change. Variable selection provides 
line widths from 0.01 to 1.00" in increments of 0.01". Upon selection of a width, 
the user is returned to the controlling menu from which the call was made. The 
variable option operates and provide line widths up to 1.00" for NPSDRAW. 
Screen representation and storage in memory reflect the selected size, but when 


printed with the QMS 1200 Printer, the line width will not exceed 0.10". 
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9. Font Source, Font Style and Font Sizes Menus 
The Font Source Menu (Figure 2.15) is presented through selection of 
the "Change Font" option from a menu or via selection of changing the font from 
the Figure Attributes Menu. This menu permits selection of the font by number, 
or style and size. The user can choose the number entry method of font style as a 
result of his experience with OZDRAW / NPSDRAW,, or he can select the font 
by style method and make selection by the style and size that suits his needs 


(Figure 2.16)*. 


* Not all font sizes and styles are available. See Appendix A for font availability. 
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Il]. NPSDRAW - SOFTWARE IMPLEMENTATION DETAILS 


The origin of NPSDRAW is as part of an M.S. thesis by Steve Firth [Ref. 1]. 
Modification of that system began with improvements to the user interface. 
OZDRAW is a medium size program, 10 - 20 K line of source code [Ref 2]. The 
difficulty with ae system lies in the fact that the number of functions and their 
inter-relationship was not well documented. To discuss the implementation and 
areas of modification. one must first be aware of the basic graphics technique of 
double buffering and be knowledgeable of the data structures used in data 


manipulation. Discussion of the more than 160 functions is then clearer. 


A. BASIC GRAPHICS OPERATING SYSTEM 

Before any discussion on the system design as a whole can be accomplished, 
one must have a basic understanding of the method by which the drawn figures 
are presented to the user. The smooth "animated" appearance of the drawing area 
is accomplished through the use of a display technique called Double Buffering. 
This technique refers to the feature of dividing all available bitplanes into two 
groups, where only one set is viewed at a time. Each group is called a buffer with 
the visible buffer referred to as the Front Buffer and the non-visible as the 
Back Buffer. With this organization all writing and drawing is done to the back 
buffer, thus alleviating any apparent drawing on the front buffer. All drawings 
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appear "instantaneously" to the user’s eye. unless the operating system as a whole 
is slowed down by either too large a drawing or other background processes. The 
back buffer is continuously drawn to and immediately "swapped" with the front 


buffer so that all screen activity viewed by the user is seen as "smooth & fluid". 


B. DATA STRUCTURES 
Within NPSDRAW, there are two primary data structures. The first, object, 
is a computer graphics system structure to store the graphics primitives that 
generate a figure. The second is a linked list of structures, named 
drawing struct. that contains the object, various parameters for drawing the 
object, numeric information and pointers to adjacent members of the linked list. 
1. Object 
The object is the graphics system’s method of storing a particular figure 
for later recall without the re-execution of the drawing routines. The drawing 
primitives are stored within the object. With a system call using the object’s 
name, the figure definitions are retrieved and a marcn to the back buffer. In our 
system, the object does not contain data such as line width. line style. texture or 
font selection. Each object can be redefined to reflect figure modifications. The use 
of objects permits easy copying for insertion into other structures. 
2. Drawing Struct 
The variable drawing struct is a structure in the C language analogous 


to the record construct in PASCAL. This is the element of the linked list which 
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contains all data unique to each figure. As seen in Table 3.1, drawing struct 
contains the figure definition (object), the figure attributes, numeric information 
and additional pointers to adjacent elements of the linked list. All this data is 
necessary to permit the easy manipulation of single or group figures, storage in 
files and subsequent printing of full page pictures. It is the sequential reading of 
these structures in the linked list that permit the continuous drawing of the 
figures to the back buffer. The elements of the linked list can be "turned off" from 
view as required to represent removal, or can be designated a figure on which a 


particular operation is performed. 


C. SOFTWARE IMPLEMENTATION 

C is the language of implementation for NPSDRAW. All segments of the 
program are referred to as functions. With the —_ number of functions in 
NPSDRAW, the best approach to a description of each function is follow through 
the program and discuss the areas using the organization of the Main Menu as a 
guide. 

1. Initialization and General Functions 

Most functions called in the "main" function deal with the initialization 

of NPSDRAW for the current drawing session. The call of main _menu() provides 


the user access to drawing routines, file storage and recall, and attribute change. 


TABLE 3.1 COMPONENTS OF STRUCTURE 
"DRAWING STRUCT" 





Component Explanation 
i type short Records the TYPE of figure, i.e. CIRCLE, 


RECTANGLE, TEXTS etc. 
short Is the figure in existence?, i.e. visible on the 
screen or deleted but recoverable. 
this font short Font with which this figure was drawn. 
Used only with TEXTS but recorded for all 
figures. 


this texture short Texture with which this figure was drawn. 
Recorded for all figures though ail do not 





use it. 


this linestyle short Line Style with which the figure was drawn. 
Recorded for all figures though all do not 


use it. 


this linewidth short Line Width with which the figure was 
drawn. Recorded for all figures though all 


do not use it. 


real linewidth float Line Width with which the figure was 
7 drawn. Recorded for all figures though all 
do not use it. Line width read in can be of 
any value. NPSDRAW maps the value read 
in to one of its own for presentation, but 
stores the correct value back out to the file. 
num info short Records the (a) number of characters point- 
_ ed to by the textptr for text TEXTS 
figures,(b) value of an attribute for attri- 
bute figure and (c) number of values point- 
ed to by a coord ptr (e.g. DIAMOND has 4 
pts, thus 8 values [x&y]). 


object | The object that contains the figure associat- 
ed with the structure. 
textbox object An object containing a_ rectangle that 
represents the area occupied by the TEXTS 
figure without text. Used in page display. 


textptr char A pointer to a text string for a TEXTS 
| figure, if present. 











| — ~— —__ —_—_—__4 
coords Hoat A pointer to coordinates of a figure, if any. 





Pointers to adjacent members of the linked 


list. 
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The last function cleans the graphics workstation for a graceful exit. The 
functions of main () are as follows: 
initialise () - undertakes all required initializations including all texture 
definitions, line style definitions, devices for queue usage and initial settings 
of attributes. Texture definitions and attribute settings are accomplished 
via calls to init teztures() and init attributes() respectively. The actual 
means of setting the attributes is discussed in section 5. 
readfonts() - reads the current font table into memory. The reading of the 
table occurs each time the system 1s activated. ensuring that the most 
recent font definitions are available to the user for the current graphics 
printer. As the table is read, the font name, number, and size 


characteristics are placed in arrays for future reference. 


initpopup() - sets NPSDRAW to accept the definitions of the various 
menus throughout the program. 


opening display() - welcomes the user to NPSDRAW with the logo of the 
Graphics and Video Laboratory. 


init gutde() - the system inserts the grids and thesis box into the linked list 
with the appropriate alignment acquired from the user through a call of 
get user alignment(). 
There are some general functions that get called repeatedly throughout 
the NPSDRAW system's operation. They are important throughout the entire 
program. They are: 


display position() - display the current position of the cursor. 


instructions() - display up to six lines of instructions on the right hand side 
of the screen. 


redraw figures() - redraw the current linked list to one or both buffers 


set orthoview() - set the correct orthoview with respect to the selected page 
alignment. 
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update bounds() - update the position of all figures, grids and the thesis 
box as a result of input from the arrow keys on the keyboard. Permits 
movement of the clipped image of the page for work on areas not visible. 


set _screen() - update the right hand side of the terminal display. Each 
attribute setting is updated at this time. 


newcursor() - select a new definition of the cursor. 
get _block() - draw a block around a specified area on the drawing screen. 
This block is used to include figures for manipulation or represent the area 


in which a particular figure is to be drawn. 


full memory() - checks for available memory before reading in any figures 
from memory. Used in both "read file" calls. 


Though not a function. most menus have an "Exit" option. This is used to exit 
the menu when work is complete. 
2. Figure Generation 

The Main Menu can be viewed as having four functional areas of 
activity. The first area is that of Figure Generation. That area includes two menu 
options that call the functions fig menu() and line menu(). Selection of an option 
from one of the menus calls either draw a( type figure ), change( an attribute ) , 
or edit obj( CHANGE ATTRIBUTES ). Each call to draw a( type ) calls the 
function(s) necessary for that particular figure to be drawn as found in Table 3.2. 
Each drawing command contains a call to insert() to store the figure in the linked 
list. If a figure has just been drawn, calls of reproduce last() will copy the last 
drawn figure and permit placement anywhere on the screen. If the last figure 


drawn is not desired. then it is removed with remove last(). Though the function 
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edit_o0bj/ CHANGE ATTRIBUTES ) is accessible from fig _menu() it is discussed later 
in section 3(d) as an editing function. 
3. Editing Functions 
The second functional area of the Main Menu is that of editing the 
screen image. This includes moving, copying, or deleting one or more figures at a 
time, grid changing. clearing the page or viewing the page as an unclipped image. 
a. Single Edit 
Single Edit functions edit only one figure at a time. A figure is 
selected from those visible on the drawing area by find figure() and returns a 
pointer to the structure containing that figure. A call on find figure() results in a 


"DRAW A(TYPE)" 


Type Figure Function Call(s) 
: RECTANGLE draw _Tectangle() 
| SEED insert seed() 
ARROW draw arrow() 
POLYGON draw polygon() 
DIAMOND get block() 
insert diamond() 
TRIANGLE get block() 


insert _triangle() 
HLINE,VLINE,LINE — draw _line() 
TEXTS draw text() 
MULTI LINE draw multi line() 
SMOOTHLINE 










draw smooth line() 





ARC get circle() 
draw arc() 
ELLIPSE get block 


insert ellipse 
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call to a check( type } for types of arc, circle, line or text. The pointer then is 
used as input to the subsequent calls that perform the actual editing. Function 
calls of edit 0bj( MOVE }) permit the repositioning of any object. Once the updated 
position is determined through movement of the object on the screen, the function 
modify object() is called. That function calls a modify function unique for each 
type of figure. An edit mode of copying is accomplished through edit 0bj( COPY ) 
and performs similarly to MOVE but makes a duplicate of the figure for placement 
on the screen with duplicate(). Deletion and recovery of deleted objects during a 
drawing session is performed by edit obj( REMOVE ) and edit obj(/ RECOVER ). 
These simply change the "exists" fleld of the structure drawing struct as 
required by the function. Recovery is then performed by drawing all figures 
present in the list with an exists field of NO. Selection of these figures is 
performed similarly to selection on the current visible screen. Upon confirmation 
of a figure, the exists field is changed back to YES. All edit function calls 
immediately set written() to FALSE indicating the current illustration is not 
saved. This flag is only set to TRUE when the illustration is saved. i.e. written to 
a file. 
b. Block Edit 

The Block Edit option selected from the Main Menu performs 
operations similar to those of Single Edit but on two or more figures as 
determined by the rectangle presented with a call to get block(). Once the block 


is placed by the user, find objects() traverses the linked list with a set of 
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coordinates and determines what if any figures exists within the block. Existence 
within the block is determined with calls to gtipt inside(), Ipt inside () or 
are inside(), as appropriate for the specific figure type. Once the figure is 
determined to be within a block, a pointer to it is placed in a temporary array for 
further action. 

Movement of a block in blockedit() takes the working array of 
structure pointers and permits movement over the drawing area. Once the block 
of figures are in the updated position, each object undergoes modify object() for 
its specific type. During movement, routine draw page() is called to show the 
changing positions of the figures. When blockedit( COPY ) is invoked, all actions 
are similar to those of MOVE but additionally calls to drawcopy() and duplicate() 
are made. 

REMOVAL in blockedit() simply utilizes the working array of figures 
found in the block and changes their "exists" field to NO. There is no recovery of 
figures in the blockedit() calls but each figure removed in this mode can be 
recovered through a single edit function as discussed earlier. 

The Block Append option is similar to the Block Copy option 
discussed previously. but copies a block from a file rather than the screen. (The 
method of file identification is discussed later in section 3(e).) All actions and calls 
parallel the COPY sequence. The functions used are bblockedit() to coordinate the 
block append of figures. bfind objects() creates the working array of pointers to 


the figures of a temporary linked list, bmove_ file() moves the new list of figures 
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over the drawing area as well as lets the arrow keys move the page. Additionally, 
it calls bdraw page() which generates the image of the new figures for movement 
about the drawing area. Once the position of the new figures is set, bmove_page() 
links up the two separate linked lists into a single entity. 

The last option to discuss from the Block Edit Menu is that of page 
movement. The unclipped version of the page is presented through a change in 
the viewport setting according to the initial page alignment. Once this image is 
present, the figures themselves are moved about the screen via changes in the 
paramters to the function set orthview via inputs from the arrow keys. Once the 
figures are placed in the desired position, all figures in the linked list are taken 
through modify objects() for update of their positional data. 

c. Grid Change 

A grid overlay that provides a guide for figure placement and 
drawing can be varied with spacing of 1/4", 1/2" or deselected altogether. The 
method of changing the grid is performed through a call to toggle(). When 
NPSDRAW is activated, the grids 1/4" and 1/2 " and the thesis box are inserted 
into the working linked list. As the user toggles the grid, the "exists" field of these 
figures are changed to represent the desired overlay. The thesis box is always 
visible, i.e. its structure "exists" field is always YES. The change in the grid is 
made through the sequential changing of the "exists" fields of the 1/2" and 1/4" 
figures. Though the grid in the 1/4" version appears as one, it is actually made up 


of two figures from the linked list, the 1/4" and 1/2" grid figures. 
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d. Figure Attribute Modification 

The last function that deals with the actual editing of figures and 
structures. is the function edit 0b3/ CHANGE ATTRIBUTES ). This function is 
available through both the Main and Figure Menus. The function call takes a 
selected object from find_figure( ) and reads from drawing struct the attributes 
associated with it via alter attributes(). A menu is displayed containing those 
attributes. The contents of the menu items is determined by reading the value 
associated with an attribute for that figure and displaying it on the menu as text. 
The font text representation is determined through use of the font number which 
is used to determine an array index. This index then accesses the arrays that 
contain the font name, number, and size data. The line width value is acquired 
directly from the structure while the line style value is converted to text through 
a case statement. Texture is not represented by text since it is visible on the 
screen. All data then is placed in the menu as options for change. Selection of any 
menu option activates the attribute select function associated with the chosen 
attribute. The actual attribute selection functions are discussed in section 3(f). 

Once the value for the changed attribute is_ selected, 
alter attributes() selects the appropriate function of changefont(), changels(), 
changelw() and changetezta(). The operation of each change function is similar so 
a general description of the procedure follows. The call to the change functions 
passes a pointer to the figure and the new attribute value. The figure is first 


evaluated if the change is appropriate. For example, changing texture of a line 
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does not make sense so no change occurs and the function is terminated. Two new 
figures are placed in the linked list, one in front of the selected figure for the new 
version and an attribute figure placed behind the selected figure to reset that 
attribute so following figures are not effected. Upon completion of these 
operations, the original figure is deleted from the linked list. 
4. File Manipulation 
a. Read in a File 

Selection of the "Read File" option calls the function read menu() 
which presents the user with a menu having options of "Read File" or "View 
Directory". A choice to read a file activates get from file() which prompts the 
user for a file name. While the user inputs the name (visible on the screen as 
typed), NPSDRAW waits for the carriage return character as a signal to evaluate 
the given name. If the filename is valid one of two actions can occur. If no picture 
is presently on the screen (flag function drawing exists ), the file is read into the 
linked list via file2list(). This function calls individual functions for each type of 
figure for actual insertion into the linked list. Once the file is completely read in, 
get from file () is terminated. If an image does exist on the screen, the user has 
three options. to quit altogether, 1.e. to not read the file, to merge the eee 
image with the file picture, or to discard the previous drawing and keep only the 
file picture. The user is provided a message as to the status of the file name 
provided, i.e. "File Read Correctly", or "File does not Exist" followed by 


"returning to Menu". The get from file() function also returns a value to the 
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calling function that indicates the status of the original read file call. It is these 
returned values that determines the next function call by read menu. If the 
returned value indicated that the file existed. and was read into the linked list, 
set orthoview(), redraw _figures() and set_screen() are called to finish the process. 

Selection of the menu option "View Directory" or incorrect input of 
a file name calls a set of directory functions. To exit this function, the user needs 
only to press the middle mouse button to get back to the "Read Menu. 

The method described above for reading in a file is the basis for the 
previously described function block append(). The associated function is that of 
bget from file(). 

b. Write File 

The process of writing a file to disk is similar in format to reading a 
file. Upon selection of the "Write File" option from the Main Menu, the user is 
presented a menu with selections of "Write File’ and "View Directory". The 
selection of "View Directory" selects the directory functions as described above 
under Read File. 

The selection of "Write File" activates the function go to file() 
which then prompts the user for a file name. The file name is checked against 
present files in the current directory. If the name has not been used, the new file is 
created and the data written. If the file is found in the directory, the user is asked 
for one of three actions - to "O"verwrite, "A"ppend, or "Q"uit. Each action is self 


explanatory. The user is provided with messages from the system regarding the 
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status of the file such as, "unable to open", "Writing to file", "Finished Writing" 
and "Returning to menu". Upon completion of a file write or the selection of 
"quit" from the menu level, the user is returned to the Main Menu. 

5. Setting Attribute Values 

The setting of the various attributes is controlled through numerous 
short functions that utilize graphics system commands to set the screen 
representation of the attributes. The setting of each attribute is done through the 
assignment of the attribute value to a variable. This variable is read each time a 
new figure is drawn to the screen and inserted into the linked list. The functions 
called are of the form set current (attribute ) and get current( attribute ). 

The general operation of each attribute change involves two steps: (1} 
get the new attribute value and (2) assign that value to the appropriate variable. 
All values are provided by the user through (a) selection of the attribute 
description from a menu or (b) selection of a texture from a pallet. The values 
returned from the attribute select functions to the calling routine are actually 
character strings. These chararacter strings are later converted to numeric values 
and used to update a current attribute setting or are used in the modification of a 
figure’s attributes. 

a. Font Selection 

When Font change is selected from a menu, the first function 
activated is fontsource() which returns a value to signify the method of font 


selection. The options for font selection are via numeric value or style & sizing. If 
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the user chooses the numeric option. he need only enter the desired font number 
at the system prompt. NPSDRAW checks the value against range limits (0 to 
MAXFONT) and then against the "Findex" array generated during reading of the 
font table at system set up. If the numeric value is contained in this array, it is 
valid and a character string representation of the value is returned to the caller. 

The second option of selection is more complex but results also in 
the return of a simple font number value. The user first sees a menu of all 
available font styles (names) . These names are not dynamically presented, i.e. 
they are hard coded in the menu presentation, though easily modified. Upon 
selection of the desired style or "No Change" (to save previous setting) the user 
sees a second menu of size combinations from which the user makes a selection. 
NPSDRAW uses both values and cross checks them with the "Fname" array for 
name availability and a matching size in the CPI & LPI arrays. If the user 
selected combination is present, the index value from the arrays is used to 
determine the actual font number. This number is then returned to the caller as 
a Character string. 

b. Texture Selection 

Values for Texture Selection are acquired through the sel tezt() call. 
The user sees a "Cross Hair Symbol" for a cursor near the lower right of the 
screen for movement over the various textures available on the pallet. Once the 


cursor is placed over the desired texture, selection is made by pressing the Middle 
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Mouse Button. If the mouse is within an area that defines a texture, a character 
string value is returned to the caller. 

c. Line Style Selection 

A call for a Line Style change is achieved through sel /s() utilizing a 

menu selection of the four available line styles. Each line style is described 
textually for selection. The selection is returned to the caller for processing as 
needed. 

d. Line Width Selection 

Line Width Selection ( sel /w() ) is similar to Line Style selection, 
but there are ten predefined line widths available for selection through a menu. 
There are additional choices of "variable" or "No Change". A_ predefined 
selection returns a character string value to the caller. The option of variable line 
width is also available. var lw() gives a means for selection of line widths in 
0.01" increments. The appropriate value is then returned to the caller. 
6. Exiting The System 

If the last option of the Main Menu is selected, the decision to exit or 
remain active is minade as a result of the boolean response to the function 
check exit(). This function checks if a drawing exists with drawing eztsts() or if 
in fact the current drawing was written to a file by checking a static variable 
"drawing written to file’. If no drawing exists or it has been saved, then a 


TRUE is returned to the main menu. If the drawing was not saved, then the user 
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is prompted with a menu for selection of options. Upon selection of exit, the 


system is in main() and final exiting of the system occurs after a call to cleanup(). 


IV. NPSDRAW : SOFTWARE MAINTENANCE 


Maintenance is the work required to be done on a software system after it is 
placed in operational use. This work includes understanding the existing system, 
documenting the existing system, enhancing the capabilities of the system, 
answering questions of users, training users, rewriting and restructuring the 
software and adapting the system to a new environment. All maintenance work 
efforts can be categorized into three sub-maintenance areas: (1) CORRECTIVE 
MAINTENANCE - maintenance performed to identify and correct software errors 
and performance deficiencies, (2) ADAPTIVE MAINTENANCE - maintenance 
performed to adapt the system to changes in the environment and (3) 
PERFECTIVE MAINTENANCE - maintenance performed to enhance the 
capabilities and performance of the system. Regarding OZDRAW. maintenance 
efforts were of a perfective nature. Though corrective maintenance was 
performed, it is not discussed here. 

No matter how well a software system meets the goals for its design and 
specification. it will have to undergo some change periodically during its lifetime 
to remain responsive to user needs. In a study of various a software systems, 
M. M. Lehman discussed various laws of Program Evolution that appeared to 


recur through the life cycles of programs [Ref. 3]. The First Law of Program 
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Evolution is the Law Of Continuing Change "which expresses a universally 
observed fact that large programs are never completed. They just evolve". With 
continuing observations and research the the First Law is now stated as: 
A program that is used and that as an implementation of its specification 
reflects some other reality, undergoes continual change or becomes 
progressively less useful. [Ref 3.] 
Though OZDRAW is not a large system, it still must evolve to respond to the 


user's needs through maintenance. The final product of this maintenance effort is 


NPSDRAW. 


A. MAINTENANCE FACTORS 

Every software product has characteristics that either decrease or increase the 
maintenance effort. A partial grouping of these is contain in Table 4.1. Those 
characteristics pertinent to the OZDRAW system are program complexity, 
number of user reports, poor documentation, good initial design and lack of 


experienced maintenance individuals. 


| TABLE 4.1 SYSTEM CHARACTERISTICS THAT INFLUENCE 
THE MAINTENANCE EFFORT 


Increase Maintenance Effort = i Decrease Maintenance Effort 















System Age Good Initial Design 
Modern Software Practices 
Automated Tools 
Data Base Management Techniques 
Good Data Administration 
Good Documentation 
Experienced Maintenance Personnel 


System Size 
Program Complexity 
Number of User Reports 
Application Type 
Poor Documentation 
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To improve the maintenance effort of NPSDRAW in the future, there are 
only two characteristics that can be dealt with at the present: documentation and 
a log of user reports. There can be no change to program complexity or 
improvement on the initial design, since these factors are set with the initial 
version of the system. The experience of the personnel who will perform 
maintenance in the future is variable and most likely to be influenced by their 


expertise in the C programming language. 


B. IMPROVEMENT OF DOCUMENTATION 

Maintenance depends on information about the system, from design through 
actual coding. Information must be recorded that provides reasons and 
justifications for each design decision and modification. Information must not be 
lost during the life of a system. Information can only be maintained through 
quality documentation. 

Many situations exist where the quality of documentation can be improved as 
maintenance is performed. Documentation can be developed and maintained with 
simple prologues at the beginning of a function. Data would consist of author's 
name, date, input, output. side effect, and exceptions if any. 

The quality and careful design of code is also a part of a well documented 
system. A standard and straightforward coding style should be be presented to 
Maintenance personnel and enforced by management. In the academic 


environment, students generally code in a style that is similar to their peers. but 
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minor variations of style can have a disrupting and possibly confusing effect on 
subsequent personnel. The maintenance personnel must have documentation that 
can be easily read and understood sufficiently in order to maintain the system. As 
documentation improves, the program will be easier to maintain in the future. 
An additional argument for good quality documentation is that maintenance 
personnel prefer using embedded, "on line" documentation. As such, if the "off 
line" documentation is weak in any area, he will tend to disregard all further 
documentation. Simple and useful forms of documentation "off line" are plain 
language explanations of functions and call hierarchy diagrams. Cross reference 
listings of files and functions are also useful when tracing a program and 
understanding its call hierarchy. A table listing indicating the callers and the 


functions called by a function can be found in Appendix B. 


C. PHYSICAL DIFFERENCES NPSDRAW / OZDRAW 

The process of improving the user interface of the interactive graphics 
illustrator has brought about numerous differences between NPSDRAW and its 
predecessor OZDRAW. These changes are discussed in Chapter V. Some basic 
comparisons may be of interest at this time. 

OZDRAW was a system of 139 files (165 functions). NPSDRAW has 133 files 
and (189 functions). The difference in file count is the result of condensing 
functions into common files. Though there are a number of new functions, the 


actual code organization has been changed slightly. The actual line count has 
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decreased almost 3%. This is not significant though and attributed to difference in 
coding style primarily for ease of changing repetitious parameters. Actual 
increase in compiled code was a little over 9%, which is not significant for the 
improved interface features. 

Overall, the difference between OZDRAW and NPSDRAW source codes is 
primarily minor organizational changes and additional functions. Future 
maintenance will not be hindered by an increase in the system complexity over 


the original version. 
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V. CONCLUSIONS 


A. IMPROVED USER INTERFACE 
NPSDRAW follows the format of its predecessor OZDRAW. If the user is 
experienced with OZDRAW, he will notice the close similarity with NPSDRAW, 
and will notice numerous improvements to the user interface. 
1. Menu Presentation & Composition 
The menu system now is faster to traverse and perform related functions. 
Generally the user is in the second level of menus, whereas OZDRAW required 
the user to move between the third and first level for most related functions. The 
user can now access some parctoet from multiple locations within the menu 
structure rather than at a single location. 
2. <Attribute Display Area 
The current settings for the attributes line style, line width, font and 
texture are visible to the user at all times. Attributes are no longer identified by 
an integer, but are represented numerically (line width, font), graphically (line 
width. line style & texture) and textually (font). 
3. Font Selection 
There are more than 100 different characters. and special symbol font 


definitions available to the user. These are selectable via their numeric designation 
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or through menu selection of style and size specifications. The selected font is 
displayed by name, number and size (CPI and LPI) in the Attribute Display Area 
and for the individual figure attributes when required. As new font definitions 
become available, simple modification to a font table provides immediate update 
to the system as the font table is read for each activation of NPSDRAW. 
4. Texture Representation & Selection 

NPSDRAW provides the user with a representation of the selected fill 
pattern (texture) as the individual figures are drawn (where appropriate). 
Additionally, the 25 different patterns are displayed in a pallet format for easy 
selection. The user no longer needs to remember a unique numeric value for any 
pattern. Once a pattern is selected, it is displayed as the current setting in the 
Attribute Display Area. Screen representations are unlimited, selections are 
limited by the printer utilized in drawing the final illustration. 

5. Line Style and Line Width Representation & Selection 

The current line style and line width selections are displayed attribute 
settings in the Attribute Display Area. The line styles remain the same (limited 
by the printer) but line widths are selectable from 0.01 to 0.1 in. Line width on 
the screen is proportional to the grid dimensions while the numeric value shown is 
the size of the printed line. The current line style is displayed within the 
Attribute Display Area. The line widths are selected from a menu containing 


preset values and as the capability of the printer changes, a variable scale 
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selection is provided for selection of widths 0.10 to 1.00 inches. Line styles are 
textually listed for selection. 
6. Figure Attribute Change 
A figure’s attributes can be changed from the Main or Figure Menu. The 
selected figure’s attributes are presented in a menu for viewing or selection of 
change. A particular attribute change can selected in the same manner as current 
settings are selected. 
¢. Geometric Figures Available 
Though all geometric figures were available through various drawing 
primitives in OZDRAW, two of the more common figures, the DIAMOND and 
TRIANGLE, were added to its predefined figures. Previously, the polygon 
function or single line functions were used to construct these. They are now 
available as primitives. 
8. Smooth Line Generation 
Within the Line Menu, a facility for drawing a free form line has been 
added. This facility provides the capability for enhancing drawings with smooth 


curved lines or cursive writing formats. 


B. NPSDRAW LIMITATIONS 
1. Font Representation 
The IRIS has the limitation of only a single font displayable on the 


terminal monitor. This font has the style of San Serif and approximate sizing of 6 
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LPI and 10 CPI. As the user selects different styles and sizes, the characters on 
the screen remain the same. Even with the proportioned red box surrounding the 
text, this becomes annoying and somewhat messy as the complexity and amount 
of text in the picture increases. 

A related font problem is the representation on the screen of the special 
symbols available with numerous font selections. The special symbols must be 
displayed on the picture as standard keyboard characters and symbols. Utilizing 
the special symbols requires the user to have a "translation table" at hand when 
entering text onto the picture. At present, the final picture can only be "proofed" 
through review of a printed image. 

2. Scaling 

As with any drawing process, it is easier to draw a figure in a larger 
format where slight errors of alignment are harder to notice. Special figures may 
be needed in various sizes for placement on different pictures. A facility to permit 
the scaling of individual or groups of figures (blocks) would provide a greater 
flexibility in drawing a high quality picture. Details in a large figure need to be 
maintained as the figure is reduced. A single drawing of a special figure could 
then be kept in the user's library. 

3. Alignment 
Consistency of figure size between similar figures is easily maintained by 
duplication of the first. either through the copy utility immediately after being 


drawn or through the utilities in single or block edit modes. The problem that 


61 


arises is the positioning of these figures with reference to a particular plane or 
point on the page. Each figure can be positioned if the user moves the mouse 
slowly. Proximity of the figure with others determines the visible accuracy of the 
alignment process. 

A related problem is the placement of line end points and arrowhead 
positioning at a specified boundary. Dependent on the line widths and styles of 
the figures and lines, precise setting of the end points of a line, or the position of 
an arrowhead becomes difficult. 

4. Text Placement 

As the user types in a text string, it is placed on the picture in a left to 
right fashion. For any picture, the text can only be placed horizontally, depending 
on the selection of landscape or portrait page orientation. The user therefore 
cannot draw a picture in the landscape mode and have the page number placed in 
a portrait orientation. 

Multiple lines of text cannot be generated automatically with the line 
feed and carriage return actions. Each line must be placed by the user, with the 
exactness of placement left up to his experience. The provision of the ability to 
automatically place text would provide a level of quality for more textual oriented 


figure displays. 


C. AREAS FOR FUTURE MODIFICATION 

As with all systems, there can always be improvements or enhancements to 
maintain their usefulness. For local usage by students, faculty and _ staff, 
NPSDRAW is more than sufficient at this time. Demand will require that it be 
modified further to maintain competence with commercially available systems. 
Below are listed various areas for future research and modification. 

1. Scaling 

When a user designs a custom figure for a project, he undoubtedly 

desires to use that figure at a later date. Just the fact that it is a special figure, 
means that it has more than a single primitive component in it. This gives rise to 
the need for a "Block Scaling" option in the system. With this feature available, 
the user could draw an original figure, and refine each component as the overall 
picture takes shape. This would make the system perform as a drawing "in 
pencil" available for simple modifications rather than "in ink" where each figure 
would need erasure before change in size. 

2. Rotation 

Along with scaling features, a feature to permit rotation of figures would 

be a nice addition. Presently, using primitives built into the system. the user can 
draw most figures required with little difficulty. But positioning of those figures 
requires a sketch of the picture beforehand to derive the general positions on the 


drawing page. Furthermore, the user draws two-dimensional images. 


Though simple three-dimensional drawing is not altogether difficult, NPSDRAW 
would be enhanced and simplified even more so with a rotation capability. 
3. Fixed Point Drawing 
"Fixed Point Drawing" is used here to describe drawing of figures that 
are centered on or have a predefined common point. Additionally it may include 
restrictions on the drawing area defined by the user during drawing of sequential 
figures. It would be a multi-function facility. Functions available could be (1) the 
user defines a point that is common to selected figures, such as a set of concentric 
circles. (2) A limit could be set dynamically on the cursor preventing movement 
outside a specified area, implemented in similar manner as the vertical and 
horizontal line drawing restriction. 
4. Insertion of a Bitmap Image 
A bitmap image insertion capability is a necessary addition. There are 
images that one cannot make on NPSDRAW,, 1.e. figures, that can be generated 
and copied from a graphics terminal via a bitmap dump. The ability to include 
such a picture on the drawing area where the user can annotate specific points 
would provide a high quality product that currently can only be acquired through 
a strictly manual figure illustration system. 
5. Point Modification 
As the user develops his skill with NPSDRAW, he begins to make more 
complicated figures to meet his needs. In the course of drawing, some figures 


require the modification of a specific point of a figure, 1.e.. the corner of a polygon 
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or the end point of a line segment. The current method is to erase the current 
figure and redraw it as necessary. If the user could have the ability to move a 
single point of a figure, the modifications could be done in a relatively short time 


as compared to redrawing the complete figure. 


D. CONCLUSION 

NPSDRAW was designed to be a system accessible by unskilled users who 
needed a quick, easy method for generating illustrations. The system is intuitive 
in its operation. It still produces a high quality product that can be easily 
modified and reproduced. The NPSDRAW system is considered a medium sized 
program (at less than 15000 lines) and thus easily accepts system modification 
and performance enhancement. The limitations and future modifications 
discussed above are by no means conclusive. As NPSDRAW’s users community 


grows, so do we expect demands for the program’s expansion and modification. 
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APPENDIX A 


NPSDRAW WITH THE QMS 1200 LASER GRAPHIC PRINTER 


This supplement to the NPSDRAW users manual is provided to illustrate the 
various attributes available with the QMS Laser Printer, and to identify system 
peculiarities. 


Attributes 

NPSDRAW uses the following attributes available on the QMS laser printer: 
(1) Four linestyles, 
(2) Ten linewidths, 
(3) 25 textures (fill patterns) and 
(4) 111 fonts. 
An example of each attribute is shown later in this supplement. When using 
various combinations of attributes and primitives, unexpected results appear on 
the drawing area and the printed page. When drawing circles or ellipses with 
other than a solid line, the image will not appear on the screen until the radius 
and minor axis exceed 1.25" for large dashed lines, 1.0" for medium dashed lines 
and 0.5" for the dotted lines. If a primitive is drawn under such conditions, only 
through actual printing of the product can it be seen. Though the image is 
present on the screen. the large linewidths imposed on the broken line will render 
a printed image with a "scalloped" edge. Examples of this aberration are shown 
with the various linewidths and styles in this appendix. 


OZPRINT 

The utility for printing the NPSDRAW figure files is OZPRINT. This print 
program is a driver for the FIGURE illustration system. OZPRINT parses the 
parameters and spawn the background process to print the picture. 


The method to print a file produced by NPSDRAW is to issue the following 
command: 


ozprint -alignment filename [-alignment filename] 
where alignment is “h’ for horizontal (landscape) and ’v’ is for vertical (portrait). 
More than one file can be printed in this manner, as long as the correct number 


of alignment values are placed in the appropriate positions. 
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A source of error is calling OZPRINT twice. or more, in rapid succession. This 
error is caused by FIGURE using a scratch file to store intermediate data. With 
more than one process executing at a time. collisions over this scratch file may 
occur. To avoid this, wait between calls to print OZDRAW figures. This potential 
trouble area can be avoided with a compound call to the OZPRINT utility. 


Calling OZPRINT with the incorrect page alignment for the current file, can 
produce unexpected results, especially if the picture extends beyond the page 
boundaries in a particular orientation. Page orientation is not5 encoded in the file. 


The Seed Point 

When a seed point is dropped, it will fill the enclosed area with the currently 
set texture. If the area is not enclosed, it will fill to the page boundary. The seed 
point will not be printed. 


Drawing a Filled Figure 

When assigning a texture to a figure there are considerations to be made: (1) 
Due to the polygon fill algorithm used in OZPRINT, only a concave figure can be 
filled. The fill pattern is unpredectable when there are overlapping figures with 
differnet textures and neither being clear. Attempts to fill a polygon with a 
segment of concave border can also induce undesirable results. (2) Filling a figure 
with other than a solid boundary, will extend the texture beyond the boundary to 
the next solid boundary or edge of the page. (3) Overlapping figures with other 
than identical textures, will only be filled with a single texture. 


Picture Overrun 

OZDRAW does not perform any clipping of figures that extend beyond the 
page boundary. This is important to consider since figures can be inadvertently 
moved off the page and stored in a file. Printing such images produces undesirable 
results. The printing system will accept the files with errors. The QMS will handle 
overrun to the right and top of the page, but cannot control the left or bottom 
margins. 
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APPENDIX B 


FUNCTION & FILE REFERENCE 
The following pages are provided for easy reference of each file, its functions 
and general operation as well as the location of each function. The functions listed 


are only those written for NPSDRAW, 1.e. does not include any system functions. 
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1. FUNCTION TO FILE CROSS REFERENCE 


lies - Functions 


Function Name 



































































To manage the values that allow the 
page to be moved up and down, or 
across. These values represent the bot- 
tom or left values of the ortho call. 
The driver function for block append - 
read a drawing in from file and attach 
to cursor for positioning. 





1pt inside.c To view a certain type of figure that is 
uniquely defined by one point, and to 
see if it lies inside a given rectangle. 
alter.c alter attributes To get the users values to change and 
pees | ESSE | cal the appeopiosfetons, a 
angle.c get angle To calculate the angle that the second 
point makes with the first point and the 
horizontal. Used in drawing arcs. 
arc.c draw arc To draw an arc and insert it into the 
a ae ee 
arc2fnl.c arc to file() (1) To write the arc definition to a file, 
arc2list () (2) to read an arc definition from a file 
barc2list() into the working linked list and (3) to 
read an arc definition from a file into a 
temporary linked list for block append. 
— 
given rectangle. 
bad data To inform the user that there is bad 
pes | | aman fie aig cad in 
bfile2list.c bfile2list To read a file and insert the drawing in 
the temporary block linked list used in 
block append. 
binsert.c binsert into list To insert the figure, with its associated 
a 
blockedit.c blockedit() | bblock- | Functions used in Move a Block, Copy 
edit () a block and Block Append. 
move picked objs() 
bmove file() 
draw _page() 
bdraw_page() 
find objects() 
bfind objects() copy- 
block() draw copy() 
border.c get bottom() 
set bottom() 
get left() set left() 
update bounds() 
bget from file 
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File Name — 


change.c 


Function Name 
change 


Operation 


To input new values for the current set 


attributes 


chan gefont.c changefont To alter the font of a chosen text string. 


changels 
changelw 


changels.c 
changelw.c 


changetexta.c changetexta To alter the texture of a chosen figure. 







check figure.c | check arc() 
check circle() 
check line() 
check text() 
circle.c 








| circle2fnl.c circle to file() 
circle2list() 


bcircle2list() 










clean list.c 


clean _list() 
clean linestyle() 

clean font() 
clean_texture() 

check Ist not default() 
cleanup 


‘cleanup.c | 
clearpage.c 
copy last.c 
copy obj.c copy ob) 


correct.c check correct 


current.c  —S|_ init’ attributes() 
set_real linewidth() 
get real linewidth() 
set current linewidth() 
get current linewidth() 
set current texture() | 
get current texture() 
| set current font() 
get current font() 
set current linestyle() 
get current linestyle() 










PE 










To alter the linestyle of a chosen figure. 
To alter the linewidth of a chosen 
figure. 


Determines whether a chosen point is 
near the control point of a figure. 





draw circle To draw a circle given a start point and 
insert it into the linked list. 


(1) Writes a circle definition to a file (2) 
writes a circle definition into the work- 
ing linked list and (3) writes a circle 
definition into a temporary linked list 
for block append. 
Removes attributes from the list that 
are unused. 





To exit the system and reset all values. 
Reset the list so no user drawings exist. 
reproduce last Copy the last figure in the linked list 


To move the picked figure to the re- 
quired position to copy it. 

To check that the chosen ‘figure is in 
fact the figure that the user intended to 
pick. 

These functions manage the variables 
that are the current state of the attri- 
butes. 


cursor.c ,newcursor Changes the cursor definition and turns 
on the new cursor. 









ile Name unction Name Uperation 


dirdraw.c dirdraw{) This subroutine queries the user to ac- 
scroll{) cess an external file and load it into the 
Init global structure. Additional scrol- 
ling menu added to the Mike Gaddis 
Directory package 


' display pos.c display position( To display the position ‘of the cursor in 
Sea page coords ie 8.5x11" 
| dist.c distance between To calculate the distance between two 





draw.c draw a The driver for drawing all the primi- 
betas tives available. 

draw erased.c | draw erased To draw the page displaying only those 

Co en | ce figures that have been erased. 


duplicate.c To duplicate the required figure 


edit menu.c edit_ menu To display the edit or block edit menu 
block edit() and get the users selection 








edit obj.c edit op} To be the "driver" for the single edit 
functions. 
ellipse2fnl.c | ellipse to file() (1)To write an ellipse definition to file, 
ellipse2list() (2) To read an ellipse definition from a 


bellipse2list({) 


file and insert into the working linked 
list and (3) To read an ellipse definition 
| | from a file and insert into a temporary 


| dinked list. 


check exit Check if the user wishes to exit without 
- saving the picture. 
















fig menu.c hg menu To display the figure menu and get the 
user's selection. 
file2list.c file2list() To read a file and insert the drawing in 
get next() the working linked list. 





find.c To find if a figure exists. 
font2fnl.c font to file() (1) Write the font value to a file (2) 


font2list() read the font value from a file to the 
bfont2list() working list and (3) read the font value 


from a file into the working temporary 
linked list 
ifont size.c font size To calculate the size of the red box to 





be placed around text to indicate the 
different size of the font. 
| To get the font selection source from 
the user i.e. by numeric value or by | 
selection of stvle and size 


fontsource.c fontsource|) 


| | 


full memory() 





Lig 





rt 
- —_ —— —— ee 
—_ 


unction Name Jperation 


To call M GADDIS‘s directory func- 
tions. 


To get the coords for a rectangle that 
inscribes an area for figure selection. 

To get from the user a circular section 
of the screen. The center point has al- 


getblock.c 
ready been determined, now all that is 


getcircle.c 
needed is the radius. 


getlist.c Get the listing for the directory 
Steve Firths idea of a queue’s operation 


graphlab.c graphlab It is the logo for the NPS Graphics and 
nn eR 

gtl inside.c gtlptinside To see if a certain class of figures that 
rl te any pint ns witin nregion, 
init.c Initialise Undertake all required initialization of 
Df | vatities and settings for NPSDRAW. 


init guides.c init guides Inserts four structures into the working 
linked list that represent the grids & 
thesis box - guides on the drawing area 

init textures.c | init textures Initialization of all possible textures. All 
texture definitions are kept here. 

insert.c . ‘insert into list The driver that inserts all figures with 
data into the working linked list. 













insert arc.c — insert arc() Takes all arc relevant information and 
binsert arc() inserts it into either the working linked 
list or the temporary linked list for 

block append. 





insert ell.c insert_ellipse() Takes all ellipse data and inserts it into 
binsert_ellipse() the working linked list or the temporary 

linked list for block append. 
insert poly.c insert diamond() Takes diamond or triangle data and in- 
insert_triangle() serts it into the working linked list from 


a drawing sequence. Not used for file to 
list or block append since in files they 
are referred to as polygons only. 
inside.c inside To see if a particular given point lies 
within a given rectangle. Used for 
selecting "rectangle" prompts on the 
. screen. | 
instruct.c —|_—sinstructions() ‘| To display the function of the mouse __ 
buttons and keys. 
invalid entry() To flag to the user that the entry he has 
entered to change an attribute is in- 


valid. 

















invalid.c 
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line.c draw line To draw a single line given the start 

pe pn 

line2fnl.c line to file() (1) To write a line to a file (2), To read 
line2list() a line definition from a file into the 
line definition from a file into the tem- 

porary linked list for block append. 

line menu.c line menu To prompt the user for the various lines 

INL __| onsen be drawn vas mene section 
lw2pix() the real linewidth and map the chosen 
linewidth to a number of pixels on the 
screen. 

list 2file.c hst to file 

Se ae all existing figures to the file. 

Is2fnl.c linestyle to file() (1) to write a line style to a file, (2) to 
linestyle2list () read a line stvle from a file into the 
blinestyle2list() working linked list and (3) read a line 

style from a file and into the temporary 

linked list for block append. 
linewidth2list() read a line width from a file into the 
blinewidth2list() working linked list and (3) read a line 

width from a file and into the tem- 


[File Name | Function Name] Operation 
bline2list() working linked list and (3) to read a 
line size.c line size() To map the set linewidth attribute to 
The driver that controls the storage of 
lw2fnl.c linewidth to file() | (1) to write a line width to a file, (2) to 
ae porary linked list for block append. 






main menu.c | main menu To display the main menu and get the 
users selection. 

map.c map() To map from page to screen coords and 

map to list() vice versa. 

mod arc.c modi y arc() | To change the position of a given arc by 
the given amount without changing its 
attributes. 

mod circle.c modify circle To move the chosen circle by the given 
amount. 





modify ellipse To change the position of a given ellipse 
by a given amount without changing its 
attributes 
To change the position of a given line 


mod ellipse.c 
by a given amount without changing its 


mod line.c 
attributes. 


mod obj.c modify object({ To select the given function to move the 
chosen figure. 


mod poly.c modify polygon To change the position of a given po- 
lygon a given amount without changing 
its attributes. 

















modify line 
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File Name §| Function Name [| © Operation 


To change the position of a seed 


mod text.c modify text To change the position of a given text | 
string a given amount without changing | 
any of its attributes. 


To move an object on the page. 
move page.c | move page 

its entirety and allow the user to move 
all the figures in one motion. 


draw multi line Draw continuous lines , i.e. adjoined 
ae non parallel segments. 
main 
not found.c not found To inform the user that when he chose 


an object for editing the cursor was not 
close enough. 






To reduce the page so it can be seen in 


poly2fnl.c =| poly to file() (1) To write a polygon definition to a 
polygon2list() file , (2) to read a polygon definition 
bpolygon2list() from a file into the working linked list 
do rectangle() and (3) to read the polygon definition 
bdo rectangle() | from a file into the temporary linked list 
do polygont) | for block append. 


bdo polygon() 


a | draw_polygon( To draw a polygon given the start 
} | point. 


‘poputil.c initpopup() pop- (1) Initialize the system for use of the 
up() showpopup() popup menu system, (2) generate the 
menus and get the users selection, and 

(3) show the menus. 


printable.c printable To calculate if a value is a printable 
get from file The driver function to read a drawing in 
read menu.c {| read menu Displays the read menu and get the 


| a re 











readfonts.c readfonttable() (1) Read the font table and fill arrays 
index 2ftable() with the data, (2) Take a font number 
and find the index to its data in the ar- 
ray. 
redraw.c redraw figures Redraw the complete picture from 
| a linked list to one or both buffers. 
| remove.c =a remove last() | To remove the last chosen drawn figure. 


e.g. remove the last drawn circle when 
circles are selected as the primitive to 
be drawn. 





! 
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ile Name unction Name _ = Operation 


seed.c insert seed() | (1) Insert a seed into the working link 
binsert_seed() list and (2) insert a seed into the tem- 
porary linked list for block append. 


seed2fnl.c seed to file() (1) To write the seed definition from the 
seed 2list () list to a file, (2) to write the seedpoint 
bseed2list() definition from a file into the working — 
linked list and (3) to write the seedpoint 
definition from a file into the temporary 
linked list for block append. 


To get the user font selection 

sel Isc === ~—«|_ select Is() = =~=~—SY|_s« To get the user line style selection. 
select lw() var Iw() To get the user line width selection. 
To get the user texture selection. 


sensible.c not sensible To flag to the user that he has tried to 
alter an attribute of a figure that does 
not make sense. For example changing a 
texture of a text string would be useless. 


set orthoview To set the ortho and viewport for the 

correct alignment so the page can be 

| drawn. 

set fname.c set filename To display the filename of the file read 

in on the top right corner of the screen. 

set mouse.c set mouse() Various functions to manipulate the 
restrict mouse() mouse. The last two functions are used 
reset_mouse() by the line functions to force the mouse 

to be either horizontal or vertical. 

To set up the right hand side of the 


| screen. 
smoothline.c | draw smooth line To draw a smooth continuous, cursive 









setnewscern.c set screen 





style line. 
store alignment.c | set alignment() To store and manage the value of page 
| get alignment() alignment. 


syntax.c syntax error( To flag to the user that one of the op- 
codes read in from the file was not 
recognized. 

draw text() Draws text given the starting point. 










insert hdg1() The headings are instruction boxes that 
replace hdgl w hdg?2 appear on the screen. 
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~ File Name 













| Function Name | — Operation — 









text 2fnl.c text to file() (1) To write a text string from the 
text2list() | linked list into a file (2) to write a text 
btext2list() string from a file to the working linked 


list and (3) to write a text string from a 
file to the temporary linked list for 
block append. 

(1) To write a texture value from the 
linked list into a file (2) to write a tex- 
ture value from a file to the working 
linked list and (3) to write a text value 
from a file to the temporary linked list 
for block append. 


toggle.c toggle grid To toggle the grid overlay that is 
displayed on the screen. 













texture2fnl.c texture to file() 
texture2list () 


btexture2list () 















view page.c view page To allow the user to view the entire 
ainh aa page unclipped at a reduced scale. 

welcome.c opening display To display the opening banner page 

width2]wnum.c | width2lwnum Return the attribute value of the passed 
ee nadie 


write.c _ go to file The driver function to write the draw- 
ing to a file. 


—_ pp eS ee ae 


| 


write menu.c | write menu() 


alr 


the users selection. 
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2. FILE TO FUNCTION CROSS REFERENCE 


Functions - Files 


unctions 


les 


‘alter attributes() alter.c = 


arc2list() 

| arc inside() 
arc to file() 
bad data() 
barc2list() 

. bblockedit() 
bcircle2list () 
bdo_polygon() 
bdo rectangle() 

| bdraw page() 
bellipse2list() 
bfile2list() 
bfind objects() 
bfont2list() 

| bget from file() 

i binsert_arc() 

‘ binsert ellipse() 

binsert into list() 
binsert seed() 
bline2list() 

blinestyle2list() 

_blinewidth2list () 
block edit() 
blockedit() 
bmove file() 
bpolygon2list() 
bseed2list() 
btext2list () 
btexture2list() 

' change() 

. changefont({) 

' changels() 
changelw() 
changetexta() 
check Ist lw() 
check Ist not default() 
check arc() 
check circle() 
check correct() 

check exit() 

‘check line() 

| check text() 

| circle2list() 


‘circle to file 


arc2fnl.c 

arc inside.c 
arc2{nl.c 
bad.c 
arc2fnl.c 
blockedit.c 
circle2fnl.c 
poly 2fnl.c 
poly 2fnl.c 
blockedit.c 
ellipse2fnl.c 
bfile2list.c 
blockedit.c 
font2fnl.c 
bread.c 
insert.c 
insert ell.c 
binsert.c 
seed.c 
line2fnl.c 
Is2fnl.c 
lw2fnl.c 

edit menu.c 
blockedit.c 
blockedit.c 
poly 2fnl.c 
seed 2fnl.c 
text2fnl.c 
texture2fnl.c 
change.c 
changefont.c 
changels.c 
changelw.c 
changetexta.c 
clean _list.c 
clean list.c 
check figure.c 
check figure.c 
correct.c 
exit.c 

check figure.c 
check figure.c 
circle2fnl.c 
circle2fnl.c 
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~ Functions 
| clean font 
clean linestyle() 
clean list() 
clean texture() 
cleanup{) 
clearpage() 
copy _obj() 
dirdraw() 
dirscroll() 
display position() 
distance _between() 
do polygon() 
do rectangle() 
draw a() 
draw arc() 
draw arrow() 
draw circle() 
draw erased() 
draw line() 
draw multi line() 
draw page() 
draw polygon() 
draw rectangle() 
draw smooth line() 
draw text() 
duplicate() 
edit menu() 
edit obj() 
ellipse2list () 
ellipse to file() 
fig menu() 
file2list () 
find figure() 
find objects() 
font 2list() 
font size() 
font to file() 
fontsource() 
full memory() 
get alignment() 
get. angle() 
get block() 
get bottom() 
get circle 














































| Files — 








clean list.c 
clean list.c 
clean list.c 
clean list.c 
cleanup.c 
clearpage.c 
copy obj.c 
dirdraw.c 
dirdraw.c 
display pos.c 
dist.c 

poly 2fnl.c 

poly 2fnl.c 
draw.c 

arc.c 

arrow.c 

circle.c 

draw erased.c 
line.c 

multi line.c 
blockedit.c 
polygon.c 
rectangle.c 
smoothline.c() 
text.c 
duplicate.c 

edit menu.c 
edit obj.c 
ellipse2fnl.c 
ellipse2fnl.c 

fig menu.c 
file2list.c 

find.c 
blockedit.c 
font2fnl.c 

font size.c 
font2fnl.c 
fontsource.c 
full.c 

store alignment.c 
angle.c 
getblock.c 
border.c 
getcircle.c 
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Functions 
get current font() 
get current linestyle() 
get current linewidth() 
get current texture() 
get directory() 
get from file() 
get left() 
get next() 
get queue() 
get real linewidth() 
get user alignment() 
getlist() 
igo to file() 

' graphlab() 

gtlpt inside({) 
index 2ftable() 
init attributes() 
init guides() 
init textures() 

| initialise() 
initpopup() 
/insert arc() 
insert diamond() 
insert. ellipse() 
insert hdg1{() 
insert into list() 
insert _seed() 
‘insert triangle() 
| inside() 
instructions( ) 
invalid entry() 
line2list() 

line menu() 

line size() 

line to file() 
linestyle2list() 
linestyle to file() 
linewidth2list() 
linewidth to file() 
list to file() — 
lw 2pix() 

main() 

main menu() 


map() 
map to list 


Files 
current.c 
current.c 
current.c 
current.c 
get dir.c 
read.c 
border.c 
file2list.c 
getq.c 
current.c 
alignment.c 
getlist.c 
write.c 
graphlab.c 
gtlptinside.c 
readfonts.c 
current.c 
init guides.c 
Init textures.c 
init.c 
poputil.c 
insert arc.c 
insert poly.c 
insert ell.c 
text.c | 
insert.c 
seed.c 

insert poly.c 
inside.c 
instruct.c 
invalid.c 
line2fnl.c 
line_menu.c 
line size.c 
line2fnl.c 
Is2fnl.c 
Ils2fnl.c 
lw2fnl.c 
lw2fnl.c() 
list 2file.c 
line size.c 
npsdraw.c 
main menu.c 
map.c. 
map.c 





unctions 
modify arc 
modify circle() 
modify ellipse() 
modify line() 
modify object() 
modify polygon() 
modify seed{) 
modify text() 
move_obj() 
move _page() 


move picked objs() 


newcursor({) 
not found() 
not sensible() 
one pt inside() 
opening display() 
poly to file() 
polygon2list() 
popup() 
printable() 
read menu() 
readfonttable() 
redraw figures() 
remove last() 


replace hdgl w_ hdg2() 


reproduce last() 
reset mouse() 
restrict mouse() 
seed to file() 
seed 2list() 
select-text() 
select font() 
select _Is() 

select lw() 

set. alignment() 
set bottom() 

set current font() 


set. current linestyle() 
set. current linewidth() 
set current texture() 


set filename() 
set mouse() 
set orthoview() 


set real linewidth() 


set screen 


- Files 


mod _ arc.c 


mod circle.c 
mod ellipse.c 
mod line.c 
mod_obj.c 
mod poly.c 
mod seed.c 
mod text.c 
move obj.c 
move page.c 
blockedit.c 
cursor.c 

not found.c 
sensible.c 
Ipt inside.c 
welcome.c 
poly 2fnl.c 
poly 2fnl.c 
poputil.c 
printable.c 
read menu.c 
readfonts.c 
redraw.c 
remove.c 
text.c 

copy _last.c 
set_mouse.c 
set mouse.c 
seed2fnl.c 
seed2fnl.c 
sel text.c 
sel font.c 
sel Is.c 

sel lw.c 
store alignment.c 
border.c 
current.c 
current.c 
current.c 
current.c 
set fname.c 
set mouse.c 
set.c 
current.c 
setnewscrn.c 
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“Functions —s#Fiiles: 
showpopup ~ poputil.c 
syntax error() syntax.c 
text 2list() text 2fnl.c 
text to file() text2fnl.c 
texture2list () texture2fnl.c 
texture to file() texture2fnl.c 
toggle() toggle grid.c 
update bounds() border.c 
var Iw() sel lw.c 
view page() view page.c 
width2]wnum() width2lwnum.c 
write menu write menu.c 





3. FUNCTIONS: CALLED FROM & CALLS TO 


FUNCTIONS 


: Function Called From Calls To 


alter attributes() edit obj( changefont() changels() 
changelw() _changetex- 
ta() instructions({) 
select font() select Is() 
select Iw() select _text() 


0bj() 

arc 2list() file2list () insert arc( 
map to list() 

ind oe) sia 

arc to file() list 2file() map() 


bad _ data() 














bfile2list() file2list() get queue() 
redraw figures() 


set. orthoview(} 


barc2list() bfile2list() map _ to list() 
binsert arc() 





bblockedit() block edit() bfind objects() 
bmove file() newcursor 
bcircle2list() bfile2list() binsert into list() 


map to list() 


bdo polygon() bpolygon2list() binsert into list() 
map to list() 


bdraw _page() bmove file() get bottom() get _left() 
set orthoview() 


bdo rectangle() bpolygon2list() binsert into list() 





bellipse2list() bfile2list() binsert into list() 
map to list() 
bfile2list() | bget from file() —*«|_-bffile2list() instructions() 


[Se 


set_ current font() 

set_ current linestyle() 
set_ current linewidth() 
set current texture() 
set real linewidth() 
set. written() 


=O 


bfind objects bblockedit() none 
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Called From” [Calla Fo 
bfont2list() bfile2list () = binsert into list() 

set current font() 
bget from _file() block edit() bfile2list() instructions() 










get queue() 
set current font() 

set current linestyle() 
set_ current linewidth() 
set current texture() 
set_real linewidth() 

set written() 


barcalist() inert ica a 
binsert ellipse() bellipse2list() binsert into list() 






































binsert into list() barc2list () font size() 
beircle2list() full memory() 
bellipse2list() get current font() 


bfile2list() bfont2list() 
binsert seed() 


get current texture() 
get current linestyle() 






bline2list () get current linewidth() 
bpoly 2list () get_real_ linewidth() 
btext 2list() set written() 
btexture2list() 

binsert seed() binsert into list() 


binsert2list() 
full memory() 


bline2list() bfile2list () 
map to list() 
blinestyle2list() bfile2list() binsert to list() 
set current linestyle() 
() 


blinewidth2list() bfile2hist binsert to list() 
lw2pix() 
set current line() 
widthdth2lwnum() 





Function 


blockedit() 


bmove file() 


bpolygon2Zlist() 


'_bseed2list() 


btext 2list() 





Called From 
block edit() 


; 
* 
é 


a 


bblockedit() 


bfile2list() 


| bfile2list() 


| bfile2list() 


btextureZlist() bfile2list () 


_ change() 








fig menu() = 


line _menu() 
main menu() 
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Cals To 


copy block () 

find objects() 
get_block() 
get bottom() 
get queue() 
move picked objs() 
newcursor() 

redraw _figures() 
set_orhtoview() 
update bounds() 





get left() 


bdraw_page() 
display _position() 

get bottom() get left() 
get queue() instruc- 
tions() modify object() 
update bounds{) 

bdo rectangle() 
bdo_polygon() 
full memory (} 


binsert seed() 
map to list() 





binsert into list() 

get current font() 

get current linestyle() 
get current linewidth() 
map to list() 





binsert into list() 
set. current texture() 
insert into list() 
select font() select Is() 
select lw() select text() 
set current font() 

set current linestyle() 
set_ current linewidth() 
set current texture() 






Function Called From 
alter attributes() insert into list() 
invalid entry() 


not_sensible() 


changefont() 


changels( 









alter attributes() insert into list() 
invalid entry() 


not_sensible() 




















) 
changelw() alter attributes() insert into list() 
invalid entry() 
not_sensible() 


changetexta() 


alter attributes insert into list() 
invalid entry() 









not_sensible() 
check Ist not default() | clean_list() 
check ind gre 
check circle() find figure() 
check correct() find figure() draw erased() get queue() 
instructions( ) 
redraw figures() 
set_orthoview() 
check exit() main menu()() instructions() newcursor() 
popup() showpopup() 
cieck Tne ind awe 
inde 
circle2list file2list() insert into list() 
map to list() 


) 

() 

i () 

clean Tinestyle() 
() 


list 2file() 





clean list 


check Ist lw() 
check font() 
check Ist not default() 
check linestyle() 

check linewidth() 


check texture() 


bieonont)) cleansaep 
clean_texture() clean _Wst() 



































Called From 
getlist() _list2file() 
main() 


Function 


clearpage() 
set written() 


copyblock() 
update bounds() 
copy _obj() copy last() edit obj() get alignment() 
get bottom() get left() 
get queue() instruc- 
tions() set orthoview() 
update bounds 


dirdraw() dirscroll() ‘none 
get _directory() 
y() 


dirseroll() 
















instructions() |= newcur- 


sor) mois 
redraw figures() 
showpopup() 

set current font() 

set current linestyle() 
set_ current linewidth() 
set current texture() 

set filename() 

set orthoview() 

set real linewidth() 
set_screen() 


main menu() 
















blockedit() display position() 
draw copy() duplicate() 
get bottom() get left() 
get queue() instruc- 


tions() set orthoview() 
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| Function | 


display position( ) 


distance between() 


do polygon() 


'do rectangle() 





1 


block edit() — block- 
edit() bmove _file() 
copy _obj() copy- 
block() draw a() 


Called From 





draw_arc() 

draw _arrow.c() 

draw _circle() 

draw _line() 

draw multi line() 
draw _polygon() 

draw rectangle() 

draw smooth line() 
draw text() 

edit _menu() edit _obj() 
fig menu() get block() 
get_circle() 

line menu() 

main menu() 

move picked objs() 
not found() 

replace hdg!l w hdg2() 
set screen(} 

draw circle() 

get circle() 


|none| 


polygon2list() insert into list() 
map to list() 
| polygon2list() _ Insert into list() 


map to list() 


Function ; Called From | Calls To 


draw a() fig menu() display position() 

line_menu() draw _arc() 

main menu() draw arrow() 
draw circle() 
draw line() 
draw multi line() 
draw _polygon() 
draw _rectangle() 
draw smooth line() 
draw text() get block() 
get bottom() 
get circle() get_left() 
get queue() 
insert_diamond() 
insert ellipse() 
insert seed() 
insert _triangle() instruc- 
tions() newcursor( ) 
remove last() 
redraw figures() 
reproduce last() 
set_orthoview() 
update bounds() 














draw arc() draw _a() display position() 
i; get left() get bottom() 
get queue() insert arc() 
instructions() 

redraw figures() 


set orthoview() 
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display _position() 
draw _erased() check correct() NONE} 
edit et 


get queue() 
set orthoview() 

draw line() draw _a( get bottom() get left() 
get queue() sei 
tions() restrict mouse() 
set_orthoview() 
redraw _figures() 
update _bounds() 

draw multi line() get bottom() get left() 










Called From Calls Fe 
redraw figures() 
get queue() instruc- 


draw _ arrow() draw a() display position() 
get_left() get _bottom() 
get queue() 
insert into list() instruc- 
tions() redraw _figures() 
set current linestyle() 
set_current_linewidth() 
set current _texture() 
set_orthoview() 
set real linewidth() 
update _bounds() 

draw circle() draw _ a( get bottom() get _left() 
update bounds() 
insert into list() 
tions() redraw _figures() 
set_orthoview() 


instructions() 

draw copy() blockedit() get bottom() get left() 
set_orthoview() 
update bounds() 
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Called From 


draw _ page() move picked objs() get bottom() get left() 
set_orthoview() 


draw _ polygon() get bottom() get left() 


get queue() 
draw rectangle() draw a 



















update bounds() 

insert into list() instruc- 
tions() redraw _figures() 
set_orthoview() 






display _position() 
get bottom() get left() 
get queue() instruc- 
tions() insert into list() 
redraw figures() 
set_orthoview() 

update bounds() 





() 
draw smooth line() draw a() display position() 

get bottom() get left() 
insert into list() instruc- 
tions() redraw _figures() 
set orthoview() 

update bounds() 

display _position() | 
get bottom() 

get current font() 

get current linewidth() | 
get_ current linestyle() | 

| get _left() get queue() | 

insert hdgi() | 
insert into list() instruc- | 
tions() Iw2pix() _ print- 
| able{) redraw figures() | 
| remove last() | 
replace hdgi w_hdg2() 


set ortoview() 


| | | update _bounds() | 


draw text() ae draw _a() 








Lol 





Called From Calls To 


duplicate() copy block() 
copy object() 





















full memory() 
get current font() 

get current _linestyle() 
get current linewidth() 
get real linewidth() 

get current texture() 
insert into list() 
modify object() 

set current font() 

set current linestyle() 
set current linewidth() 
set current texture() 
set real linewidth() 






edit menu() main menu() display position() in- 
structions() popup() 
redraw _figures() 
showpopup() 


set_ screen() 


















edit obj() edit menu() alter attributes() 
fig menu() copy obj() 
main menu() display position() 
find figure() 
get bottom() 
get current linestyle() 
get current linewidth() 
get current texture() 
get left() get queue() in- 
structions() newcursor() 
redraw figures() 
set current texture() 
set current linestyle() 
set current linewidth() 
set orthoview() 
set written() 
update _bounds() 








ellipse2list() 


ellipse to file() 






file2list() insert ellipse() 


map to list() 


list 2file() map() 


Function Called From , 


fig menu() main menu() 
file2list () get from _file() 
find figure() edit obj() 
font2list() file2list () 
‘font size() | binsert into list() = 
btext2list() 
changefont() 


draw_text() 
_ insert _into_list() 
modify text() 
text 2list() 





font to file() list 2file() 
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Calls To 
change() 
display _position() 
draw a() edit obj() in- 


structions() popup() 
redraw _figures() 
showpopup() 

set_ screen() 

arc 2list() bad data() 
circle2list() ellipse2list() 
font2list() 

get current font() 

get current _linestyle() 
get current linewidth() 
get current texture() 
get_next() 

insert into list() 
line2list() linestyle2list() 
linewidth 2list() 
polygon2list() seed2list() 
set current font() 

set current linestyle() 
set current linewidth() 
set_ current texture() 
syntax error() text2list() 
texture2list() 

check arc({) 

check circle() 

check correct() 

check line() check text() 


instructions() 





insert into list() 
set current font() 


"index 2ftable() 


get block() 


Function 


fontsource() 


full memory() 


get alignment () 


get angle() 


Called From 


‘select font() instructions() | newcur- 


sor() popup() 
redraw _figures() 


set_screen() | showpop- 
up() 

binsert_ into list() get queue() 

bline2list() redraw figures() 

bpoly 2list() dupli- set_orthoview() 

cate() 

insert into list() 


line2list() poly 2list() 

bmove file() copy- | get queue() 
block() copy obj() , 
init guides() 
move _obj() 

move _page() 

move picked objs() 
restrict mouse() 

set orthoview() 


| set_mouse() 
| set screen() 


| update bounds() 


view _page() 

draw arc() 

draw arrow() 

blockedit() draw a( display position() 
get bottom() 
get current linewidth() 
get_left() get queue() in- 
structions() lw2pix() 
redraw figures() 
set_orthoview() 
update bounds() 





Function 
get bottom() 


get circle() 






get current font() 























Called From 
bdraw page() _ block- 


edit() | bmove file() 
copy_obj() copy- 
block () draw a() 
draw_arc() 

draw _arrow() 

draw circle() 

draw _line() 
draw_page() 

draw copy() 

draw multi line() 
draw _polygon() 
draw _ rectangle() 
draw smooth line() 
draw text() edit obj() 
get block() getcircle() 
move picked objs() 
move _ obj() 

not found() 

restrict mouse() 

set orthoview() 


draw a() 


bfile2list () 
binsert into list() 
btext2list() 

draw text() dulpi- 
cate() file2list() 
insert into list() 
select font() 
set_screen() text2list() 
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Calls To 


none] 


display position() 
distance _between() 
get bottom() get left() 


get queue() instruc- 
tions() redraw _figures() 
set orthoview() 

update bounds() 


‘none| 


Function Called From Calls To 


get current linestyle() bfile2list() ‘none| 
- binsert into list() 
binsert seed() 
btext2list() 
draw _arrow() 
draw text() dupli- 
cate() file2list() 
insert into list() 
insert seed() 
modify seed() 
/ set screen() text2list() 
get current linewidth() | bfile2list() ‘none 
binsert into list() 
binsert seed() 
btext2list() 
| draw arrow() 
draw text(} dupli- 
| cate() edit obj() 
| file2list()  getblock() 
| 


insert into list() 
insert _seed(} 
set screen() text2list() | 


— 


get current texture() | bfile2list() | jnone| 

binsert into list() 1 
draw arrow()  dupli- 
cate() edit obj() 

| file2list () . 
insert into lst) 
insert seed() 
binsert seed() 


set_screen(} 


|get_directory() _ read _menu() dirdraw() dirscroll() get- 


| write menu() | list() get queue() — in- 
| | structions() | 


Called From 


get from _file() read menu() drawing exists() 
get queue() file2list() in- 
structions() 
set current font() 
set current linestyle() 


set current linewidth() 
set_ current texture() 
set real linewidth() 

set filename() 

set written() 





bdraw page() _ block- [none] 


edit() bmove file() 
copy _obj() copy- 
block () draw a() 
draw _arc() 

draw _arrow() 

draw circle() 

draw copy() 

draw multi line() 
draw_page() 

draw _polygon() 

draw rectangle() 

draw smooth line() 
edit obj() getblock() 
getcircle() draw line() 
move obj() 

move picked objs() 
not found() 

restrict mouse() 
replace hdgl w dhg2() 
set_orthoview() 


get next() bfile2list() file2list() none} 
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Function 


get queue() 


Called From 


bad data() 
bget from file() block- 


edit() ~ bmovefile() 
check correct() 


copy_obj() copy- 
block() draw a() 
draw _arc() 

draw _arrow() 

draw circle() 

draw line() 

draw multi line() 
draw_polygon() 

draw rectangle() 
draw text() edit obj() 
full memory () 

get user alignment() 
get directory() 

get circle() 

get from file() __ get- 
block() go to file() in- 
valid() move obj() 
move page() 

move picked objs() 
not_found() 

select font() 

select Iw() _ sensible() 
syntax error() 


view page() 
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inone| 





Called From Calls To 


get real linewidth() binsert into list() | ‘none| 


draw arrow() 
get user alignment() 











insert into list() 


get queue() inside() 
set alignment() 










go to file() wite_menu() get queue() instruc- 
tions() list to file() 
set written() 

gtipt inside() find objects() inside() 


index 2ftable() alter _attributes() changefont() changetex- 
font size() ta() changels() 
select font() changelw() 
set. screen() index2ftable() — instruc- 
tions() popup() 
select font() 
select texture() 
select |s() select lw() 








set screen() | showpop- 
up() 
init guides() main() get_alignment() 
insert into list() 
sai Td 
insert arc() arc2list()  barc2list() insert into list() 


insert arc() 


insert_diamond() 


insert hdgl() draw text() get bottom() get left() 
i 


insert into list() 


Function 


insert into list() 















































insert seed() 


insert triangle() 


inside() 


Called From 
change() changefont() 
changels() changelw() 
changetexta() 
draw a() 
draw arrow() 
draw circle() 
draw _line() 
draw multi line() 
draw_polygon() 
draw rectangle() 
draw smoothline() 
draw _text() dupli- 
cate() file2list() 
font to file() 
init guides() 
insert arc() 
insert diamond() 
insert. ellipse() 
insert seed() 
insert. triangle() 
line to file() 

Is to file() 

lw to _file() 
poly to file() 
text to file() 
texture to file() 


seed 2file() 


get user alignment() 
gtlpt inside() 

one pt inside() 
select text() 
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Calls To 


full memory() 
font size() 
get current font() 

get current linestyle() 
get current linewidth() 
get real linewidth() 

get current _texture() 
set written() 
























get current linestyle() 
get current linewidth() 
get current texture() 

insert into list() 











insert into list() 


——_- — 
-—— — = = 


Called From [Calls To 


instructions() alter attributes() inone| 
bget from _file() 
block edit() block- 


edit () bmove _file() 


check _exit() clear- 
page() copy block () 
copy_obj() 


check correct() 

draw a() draw _arc() 

draw _arrow() 

draw circle() 

draw _line() 

draw multi line() 

draw_polygon() 

draw _rectangle() 

draw smooth line() 

draw _text() 

edit menu() edit obj() 

fig menu() 

find figure() 

fontsource() 

get from _file() 

go to file() 

get directory() get- 

block() get circle() in- 

valid() __ line_menu() 

main menu() 

move obj() 

move _page() 

move picked objects() 

not found() 

read _menu() 

select font() 

select Is() select_Iw() 

select text() sensible() 

set _screen() 

view page() 

write menu() 

invalid entry() changels() changelw() get gueue() instruc- 

changetexta() tions() redraw figures() 
set orthoview() — 
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Function Called From . - Calls To 


line2list() file2list () full_ memory() 
insert into list() 


map to list() 


line menu() main menu() change() 
display _position() 
draw a() _ instructions() 
popup() redraw _figures() 
show popup() 
set_screen() 
icate() 


line size() change() duplicate 
ine_t0 Ale ie 
( 








set current _linestyle() 


) 
) 

finesiyle_to_fle() 
() 


linewidth 2list() file2list insert into list() 


linest yle2list() file2list insert_into list() 






lw2pix() 
set current linewidth() 
width2lwnum() 


inewideh_t0_Ale 
list to file() go to file() arc to file() 
- circle to file() cleanup() 
clean_list() 
ellipse to file() 
font to file() 
line to file() 





linestyle to file() 
linewidth to file() 
poly to file() 
seed to file() 
text_to file() 
texture to file() 






























btext2list() change() 
changefont() 
changelw() 

draw _arrow() 
draw_text() dupli- 
cate() getblock() 
insert into list() 
insert_seed() 
linewidth2list() 

modify seed() 


Called From 
modify text() 


Iw2pix() binsert into list() 
move obj() text2list() 












cleanup() 

get user alignment() 
init guides()  initialise() 
initpopup main menu() 
opening display() read- 





binsert seed() 
main() Activated from the 
illustrator system call 
NPSDRAW 
( 


blinewidth2list() 
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fonttable() 


block edit() change() 
check exit() clearpage() 
display _position() 

draw a() edit obj() 
edit menu() fig menu() 
instructions() 

line menu() popup() 
read _menu() 


redraw figures() 
set_screen() 

set orthoview() 
showpopup() 
toggle grid() 
view page() 
write _menu() 





Called From Calls To 


map() arc to file() 
circle to_file() 
ellipse to file() 
line to file() 
poly to _file() 
seed 2file() 
text to file() 


map to list() arc2list() —_ barc2list() [none] 
bcircle2list() 
bellipse2list () 
bline2list() 
bpolygonz2list() 
bseed 2list () 
btext2list() 
circle2list() 
ellipse2list() line2list() 
polygon2list() 
oe “ae 


ei eel) | wasn) ——— 


modify ellipse() | modifyuopject() ae 


modify Tine() ody object) 


modify object() bmove _file() dulpi- modify arc() 
cate() move page() modify circle() 
move picked objs() modify ellipse() 
move obj() modify _line() 
modify seed() 
modify text() 
modity _polygon() 








modify _polygon() modify object() 


ions seed() modify ne get current linestyle() 


move “obj() edit mots oes get Teli get bottom() 
get queue() instruc- 
tions() modify object() 

set_orthoview() 

| update bounds() 


move page() edit menu() get alignment() 
get queue() instruc- 


tions() modify object() 
| set_written() 
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Function Called From | con Calls To 


blockedit() display position() 
draw _page() 
get alignment() 
get bottom() get _left() 
get queue() instruc- 
tions() modify object() 
set_orthoview() 
set_written() 
update bounds() 


move picked objs() 


newcursor( ) bblockedit() block- 
edit() check exit() 
clearpage() draw a() 
edit obj() fontsource() 
opening display() pop- 
| up() —— read_menu() 
select font() 
select Is() select lw() 
select text() showpop- 
up() write menu() 


not found() blockedit() display position() 
find figure() get bottom() get left() 
get queue() instruc- 
tions() set orthoview() 


not _sensible() changefont() get queue() instruc- 
changels() changelw() tions() redraw figures() 
set_orthoview() 


ind_ objec) 
poly_t0_Ale() isto Hel 










Called From 


popup() alter attributes() 
check exit() clear- 
page() — edit_ menu() 
fig menu() 
fontsource() 
line _menu() 
main menu() 
read _menu() 
select font() 
select Is() select lw() 
write menu() 









ae | 
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printable() 
( 


get directory() 
get from file() instruc- 
tions() newcursor() pop- 
up() redraw figures() 
set orthoview() 

set screen() | showpop- 


up() 





Called From Cails To 


redraw figures() bad data() blockedit() none] 
check correct({) clear- 


page() draw a() 
draw arc() 

draw _arrow() 

draw circle() 

draw _line() 

draw multi line() 
draw _polygon() 

draw _rectangle() 
draw smooth line() 
draw_text() 

edit menu() edit _obj() 
fig menu() 
fontsource() 

full memory() get- 
block() get circle() in- 
valid() line _menu() 
main menu() 

read _menu() 

select font() sensible() 
set. screen() 
view_page() 

write menu() 


draw a() draw text) 


replace hdgl whdg2() get bottom() get _left() 


insert into list() 


_a() 
_text() 
remove _last() 
_a() 
reset mouse() draw _line() get alignment 
select lw() 
_line() 
_file() 













() 

restrict mouse() draw line get alignment() 

get left() get bottom() 
sad 10 HI) 
seed 2list() file2list() insert seed() 

map to list() 
select text() alter attributes() inside() instructions() | 

change() newcursor( ) 
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Function Called From 


select font ( ) rr 


\ 


alter attributes() 
change() 









alter attributes() 
change() 


select 1s() 
select lw() 


set alignment() get user alignment() 


set bottom() set. screen() 


bfile2list() bfont2list() 
change{) clearpage() 
duplicate() —file2hist() 
font2list() 

get from file() 


bfile2list() 

bget from file() 

blinestyle2list() 

change() _clearpage() 

| draw arrow()  dulpi- 

| cate() edit obj() 
file2list() 

| get from file() 

linestyle2list() 









alter attributes() 
change() 


set current font() 


|set current linestyle() 


‘set current linewidth() | draw arrow() 
bfile2list() 

bget from _file() 
blinewidth2list() 
change() _clearpage() 


duplicate() edit obj() 
| file2list() 

get from _file() 

linewidth2list() 
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~ Calls To 
fontsource() 
| get current font() 
get queue() 
index2ftable() —_ instruc- 
tions() newcursor() pop- 
upl) redraw figures() 
set. screen() | showpop- 
up() 
instructions() — newcur- 
sor() popup() showpop- 
up() 
get queue() instruc- 
tions() newcursor() pop- 


up() showpopup() 
varlw() 









set. screen() 


set_screen() 


| set screen() 


~ Function Called From 


'set current texture() | bfile2list() 

. - bget from _file() 
change() _clearpage() 
draw arrow()  dupli- 


Calls To 


set screen() 





cate() edit obj()_ ; 
file2list{) 
get from _file() 
texture2list () 
texture2list() 

set filename() clearpage() [none] 
get_from_file() 

set left() set_screen() [none] 

set _orthoview() bad _ data() get _alignment() 
bdraw page() block- | get a get left() 
edit() bmove file() get queue() 


| copy_obj() copy- 
block() draw _arc() 
draw _arrow() 
draw copy() 

| draw page() draw a() 

| draw circle() 
draw line() 

draw multi line() 
draw_polygon() 
draw rectangle() 
draw smooth line() 
draw text() edit obj() 
full memory() 
get bottom() 

| get _circle() get _left() 
getblock() 

_ insert diamond() _ in- 
valid() main menu() 
move _ob}() 

| Move _picked_objs() 

- not found() | 
read _menu() sensible() 
set_screen() 
syntax error() 


clearpage() | 
_ check correct({) 
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Function 


‘set real linewidth() 


set screen() . 


alter attributes() 


Called From 


bfile2list() 

bget_ from_file() 
change() clearpage() 
draw arrow()  dulpi- 
cate() file2list() 
get from file() 
clearpage() copy_last() 
edit_menu() 


| fig_menu() 
| fontsource() 


line_menu() 

main menu() 

read _menu() 

set current font() 

set current linestyle() 


| get current linewidth() 


showpopup() 


syntax error() 


text 2list() 


set current texture() 
select font() 

view page() 

write menu() 

alter attributes() 
clearpage() 

check exit() 
edit_menu() 

fig menu() 
fontsource() 

line _menu() 

main menu() 

read menu() 

select font() 

select Is(} select lw(] 
write menu() 


bfile2list() file2list() 





hle2list{ ) 
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Calls To 


none} 


display _position() 
get_alignment() 

get current texture() 
get current linestyle() 
get current linewidth() 
get current font() 


index2ftable() — instruc- 
tions() redraw _figures() 
set bottom() _ set left() 


set orthoview() 


newcursor{( ) 


get queue(} 

redraw _figures() 

set orthoview() 

font size() 

get current font() 

get current linestyle() 


| get currnet linewidth() 


insert into list() 


| | | map to list() | 


Called From 
text_t0_file() stil 


() 
texture2list() list 2file() insert into list() 
set_ current texture() 
cextoreo Bl) | THD 
eel gr) 


update bounds() 


























g 


width2lwnum({ ) blinewidth2list () none! 
linewidth2list() 


_ | 









blockedit() 
bmove file() 
block{) 

draw a() 
draw arrow(}) 

draw circle() 

draw line() 

draw multi line() 
draw _ polygon() 

draw _rectangle() 

draw smooth line() 
draw text() edit obj() 
get block() 

get circle() 

move obj() 

move picked objs 


get _alignment() 





copy- 
copy_obj() 


() 





get alignment() 
get queue() 
tions({) 


instruc- 
redraw _figures() 
set screen() 


get directory() 

go to _file() instruc- 
tions() newcursor() pop- 
redraw figures() 


up() 
showpopup() 
set screen() 





APPENDIX C 


PRODUCTS OF NPSDRAW 


The following pages are examples of pictures created on NPSDRAW. 
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FREE BODY DIAGRAM 


(Agent on Surface) 





Example 1 
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TERRAIN MOBILITY MODEL 


MOBILITY ENVIRONMENT 


Wission 
Events MISSION a AREA OF INTEREST 


EXPERT 


Situation 


Events PoOLTUATION 
Context-—-Dependent 


Profile Generation View Generation 





Example 2 
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523+4d1 


Sea. 
5d2 


TLD FOO 


view from the side 






52,+4d1 





view from the front we 


ASV Leg Configuration 
Example 3 
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area-cost map model of region boundary 


Real-world region boundary 


(a). Real-World and Model Region Boundaries 








cost rate Cy 


a 


E 


high-cost region A G 


Pl 






area-cost map 


low-cost region 
oO S g model of region boundary 


cost rate oT 


(b). Error Analysis Tllisteacron 


Path-Cost Error Due To Misplacerd Boundaries 


Example 4 
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Cost U2 Region 
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Optimal Paths Through Adjacent Areas 





Example 5 
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do 


dy 


Se | 


So 


SS 


Inset - generating problem 





Close (X) Function 


Example 6 
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